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(software  development  system)  have  shown  that  this  technique  of  interactive 
assembly  language  software  development  promises  to  provide  a  factor  of  from 
3  to  10  decrease  in  program  development  time.  ^ 

Project  ARIES,  which  was  started  by  the  author  while  in  graduate 
school,  has  resulted  in  the  creation  of  ARIAN  II,  a  floppy  disk-based 
operating  and  software  development  system  for  interactive  assembly  language  ^ 
software  development.  It  is  an  integrated  tool  designed  to  work  specifically  ^ 
with  the  ARIES-I  hardware  configuration,  and  its  34  resident  commands 
give  the  user  the  abilities  to  create  and  manipulate  text  and  binary  files, 

^  to  assemble  the  text  of  an  assembly  language  source  program,  to  execute 
and  breakpoint  such  a  program  with  a  number  of  debugging  aids,  to  communicate 
with  an  external  computer  via  a  modem,  and  to  examine  and  modify  the 
microcomputer's  memory  directly. ^ 

ARIAN  II ' s  resident  commands  are  supplemented  by  disk-based  transient 
commands  which  may  be  created  at  the  discretion  of  the  user  and  loaded 
into  the  microcomputer  and  executed.  The  user  also  has  the  ability  to 
create  temporary  memory-resident  commands  which  may  also  be  invoked  by 
the  user  at  his  discretion. 

The  software  development  capabilities  of  ARIAN  II  are  notably  limited 
to  "small"  assembly  language  programs  on  the  order  of  40K  bytes  (source) 
or  less.  ARIAN  II,  however,  provides  a  useful  tool  for  software  development 
of  programs  of  this  size. 
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CHAPTER  1 
INTRODUCTION 


ARIAN  II  is  an  operating  system,  a  program  which  allows  its  user  to  execute 
and  control  other  programs,  designed  specifically  for  a  microcomputer  possessing 
the  ARIES-I  hardware  configuration.  Based  on  the  original  ARIAN,  or  ARIAN  I, 
ARIAN  II  is  extensively  integrated  with  the  ARIES-I  hardware  configuration;  the 
microcomputer  hardware  and  the  ARIAN  software  are  designed  to  work  together  with 
each  other's  configuration  in  mind.  This  type  of  design  —  that  of  an 
integration  of  hardware,  firmware,  and  software  within  a  single  system  — 
produces  a  unique  and  useful  tool. 

This  tool  is  designed  to  be  used  for  software  development.  The  hardware 
configuration  was  organized  and  coordinated  with  ARIAN  to  give  the  user  the 
maximum  amount  of  benefit  from  his  resources.  This  hardware  configuration 
consists  of  the  following: 

1.  at  least  40K  bytes  of  RAM, 

2.  the  Z80  microprocessor, 

3.  two  5  1/M-inch  floppy  disk  drives  (Shugart 
SA-400)  with  North  Star  floppy  disk  controller, 

4.  a  PROM  programmer, 

5.  a  high-speed  (9600  baud)  CRT  and  keyboard,  a 
printer,  a  modem,  and  a  second  high-speed  CRT  VDM,  with 
their  associated  serial  I/O  ports,  and 

6.  three  parallel  I/O  ports,  including  a  front 
panel  LED  display. 

As  the  user  can  see,  the  ARIES-I  hardware  configuration  is  designed 
specifically  with  software  development  in  mind. 

ARIAN  II  is  specifically  designed  to  aid  in  software  development  for  the 
Z80  microprocessor.  Its  3^  commands  give  the  user  the  abilities  to  create  and 
manipulate  text  and  binary  files,  to  assemble  the  text  of  an  assembly  language 
file,  to  execute  and  breakpoint  his  assembly  language  programs  with  a  number  of 
debugging  aids,  to  communicate  with  an  external  computer  via  the  modem,  and  to 
examine  and  modify  the  microcomputer's  memory  directly. 

While  ARIAN  II  is  running,  the  user  may  be  in  any  one  of  a  number  of 
command  or  data  entry  modes.  These  mode  are: 

1.  Block  Line  Entry  Mode.  This  mode  permits  the 
entry  of  a  block  of  lines  into  the  primary  file.  It 
allows  the  user  to  enter  lines  into  the  primary  file 
without  typing  the  line  numbers;  ARIAN  II  automatically 
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prefixes  each  line  with  a  line  number  and  optionally 
renumbers  the  primary  file  when  the  user  exits  this 
mode. 

2.  Command  Mode.  Command  mode  permits  the  user 
to  type  a  command  to  ARIAN  II. 

3.  Display  Mode.  Display  mode  is  the  mode  in 
which  ARIAN  II  is  displaying  a  directory  or  lines  of 
text  to  the  user.  He  can  stop  this  display  while  it  is 
being  created  by  keying  <ESC>.  All  displays  are  paged, 
and  the  user  is  prompted  with  a  "?"  at  the  bottom  of 
each  page  to  find  out  if  he  wishes  to  continue  the 
display;  the  user  must  respond  with  "N"  or  ”n"  to  stop 
the  display  and  anything  else  to  continue. 

4.  Edit  Mode.  This  mode  is  the  command  system 
invoked  by  the  EDIT  Level  2  command  or  XEDIT  Level  3 
command. 

5.  Terminal  Mode.  Terminal  mode  is  an 
interactive  subsystem  of  ARIAN  II.  The  user  can 
communicate  with  an  external  computer  via  the  modem  and 
acoustic  ooupler  while  in  thjs  mode.  It  is  invoked  by 
the  TERM  command. 

6.  Utility  Mode.  This  is  the  Utility  Subsystem, 
invoked  by  the  UTIL  command. 

This  is  a  user's  manual  for  ARIAN  II.  ARIAN  II  is  different  from  ARIAN  I 
in  many  respects,  and  the  ARIAN  I  user  is  encouraged  to  read  this  manual  and  its 
appendices  before  using  ARIAN  II.  It  is  hoped  that  the  user  will  find  ARIAN  II 
to  be  at  least  as  useful  and  as  far  above  its  predecessor,  ARIAN  I,  as  ARIAN  I 
was  above  its  predecessors.  IDIC 
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CHAPTER  2 

The  ARIAN  II  EXECUTIVE 


The  heart  of  ARIAN  II  is  a  very  small  program  called  the  Executive.  This 
program  performs  the  following  functions: 

1.  Resets  the  system  stack,  sets  interrupt 
mode  zero,  and  disables  interrupts, 

2.  Displays  the  ARIAN  II  prompt  to  the  user 
via  the  principal  I/O  channel, 

3.  Inputs  a  command  from  the  user  through 
the  input  line  editor, 

4.  Parses  the  input  command  line,  and 

5.  Searches  for  end  transfers  control  to  the 
command  routine  if  found. 

The  Executive  was  designed  to  take  advantage  of  the  modularity  of  ARIAN  II. 
The  five  functions  of  the  Executive  exist  as  small  linear  blocks  of  code  within 
the  Executive  itself  or  as  subroutines  within  ARIAN  II.  Additionally,  the 
command  routines  themselves  exist  as  subroutines,  either  memory-resident  or  on 
disk.  Hence,  the  Executive  is  very  small  and  consists  mainly  of  subroutine 
calls. 

The  body  of  this  chapter  describes  these  five  sections  of  the  ARIAN  II 
Executive  is  detail. 


1  The  Executive  Reset 

The  purpose  of  the  system  reset  in  the  Executive  is  to  stabilize  the 
environment  of  ARIAN  II.  ARIAN  II  does  not  use  interrupts,  so  the  setting  of 
interrupt  mode  zero  and  the  disabling  of  interrupts  ensures  that  the  ARIAN  II 
Executive  will  not  be  interrupted  by  a  maskable  interrupt.  ARIAN  II  contains  a 
trap  for  non-maskable  interrupts  which  returns  control  to  the  Executive. 

ARIAN  II  typically  uses  two  stacks  —  one  for  the  ARIAN  II  system  and  one 
for  the  user.  In  this  way,  the  user  can  employ  the  program  debugging  facilities 
by  executing  a  section  of  his  code,  returning  control  to  ARIAN  II  and  examining 
registers,  etc.,  and  then  continuing  the  execution  of  his  code  with  a  minimum  of 
difficulty.  Hence,  the  Executive's  function  of  resetting  the  ARIAN  II  system 
stack  ensures  that  the  user's  stack  will  not  be  altered  by  the  execution  of 
ARIAN  II  routines. 

Secondly,  abnormal  termination  of  an  ARIAN  II  routine,  such  as  in  the  case 
of  an  error,  may  result  in  an  unbalanced  system  stack.  The  feature  of  the 
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Executive  of  resetting  the  system  stack  on  each  pass  through  the  Executive 
ensures  that  the  stack  is  balanced. 


2  The  ARIAN  II  Prompt 

The  prompt  of  ARIAN  II  serves  two  purposes:  (1)  it  informs  the  user  of  the 
status  of  the  disks  and  (2)  it  tells  the  user  that  ARIAN  II  is  ready  to  receive 
a  command. 

The  prompt  consists  of  two  digits  followed  by  a  greater-than  sign  (’>'). 
ARIAN  II  is  designed  to  be  used  as  a  multiple-drive  system,  and  two  drives  are 
of  particular  interest  to  ARIAN  II.  One  is  the  Command  Drive,  and  the  other  is 
the  Logged-in  Drive.  The  Command  Drive  holds  a  disk  which  contains  the 
transient  routines  executed  by  ARIAN  II.  These  are  called  the  Level  3  commands, 
and  this  feature  of  transient  routines  is  referred  to  as  Command  Level  3-  If 
Command  Level  3  is  engaged  and  the  ARIAN  II  Executive  does  not  find  the  name  of 
the  current  command  in  its  local  command  directories,  it  will  load  the  directory 
of  the  Command  Drive  and  search  for  a  Level  3  command  of  the  specified  name.  If 
an  entry  is  found,  it  will  be  loaded  and  executed.  Level  3,  as  well  as  Level  1 
and  Level  2,  commands  will  be  discussed  later  in  this  chapter. 

The  two  digits  in  the  prompt  give  the  numbers  of  the  Command  and  Logged-in 
Drives,  in  that  order.  ARIAN  II  supports  up  to  four  drives,  and  the  first 
digit,  which  gives  the  number  of  the  Command  Drive,  may  take  on  values  from  0  to 
4,  while  the  second  digit,  which  gives  the  number  of  the  Logged-in  Drive,  may 
take  on  values  from  1  to  4.  If  the  number  of  the  Command  Drive  is  0,  then 
Command  Level  3  is  turned  off;  otherwise,  the  given  number  is  the  number  of  the 
drive  from  which  Level  3  commands  will  be  loaded. 

Examples  of  the  ARIAN  II  prompt  are: 

01>  —  Command  Level  3  is  off,  1  is  the  number  of  the  Logged-in  Drive 

22>  —  2  is  the  number  of  both  the  Command  Drive  and  the  Logged-in  Drive 
41>  —  4  is  the  Command  Drive  and  1  is  the  Logged-in  Drive 


3  The  ARIAN  II  Input  Line  Editor 

All  typing  done  while  the  user  is  in  ARIAN  II  with  the  exception  of  the 
immediate  prompts  is  processed  by  the  ARIAN  II  Input  Line  Editor.  This  editor 
collects  each  character  as  the  user  types  it,  stores  it  in  a  buffer,  and  allows 
the  user  to  correct  any  typing  errors  he  has  made.  When  the  user  terminates  the 
line  by  typing  a  carriage  return,  this  buffer  is  terminated  and  ARIAN  II 
processes  the  contents  of  the  buffer.  This  routine  is  used  while  ARIAN  II  is  in 
Command  Mode  and  Block  Line  Entry  Mode,  and  it  may  be  called  explicitly  by  the 
user  (see  the  chapter  on  the  ARIAN  II  assembler). 

As  each  character  is  typed,  it  is  checked  to  see  if  it  is  an  editor  control 
character.  If  it  is,  the  function  of  the  control  character  is  executed;  if  not, 
the  character  is  saved  in  the  input  line  buffer  and  echoed  to  the  principal  I/O 
device.  When  the  user  has  finished  typing  the  line,  he  terminates  it  with  a 
carriage  return.  No  character  is  echoed  as  a  result  of  this,  and  control  is 
returned  to  the  calling  program. 

The  following  is  a  list  of  all  the  editor  control  characters: 
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1.  the  Escape  (<ESC>)  key.  When  typed,  <ESC>  is  printed  on 
the  principal.  I/O  device  as  a  dollar  sign  ('$')  followed  by  a 
<CR>.  This  key  tells  the  editor  to  delete  the  line  typed  so  far 
and  start  over  with  a  new  line. 

2.  the  Line  Feed  (<LF>)  key.  This  key  echoes  as  a  <CR>  and 
does  not  affect  the  line  contained  in  the  input  line  buffer.  The 
sole  purpose  of  this  function  is  to  allow  the  user  to  continue 
typing  his  line  on  the  next  physical  line  of  the  principal  I/O 
device.  No  character  is  entered  into  the  buffer  as  a  result  of 
this  key,  so  the  user  must  ensure  that  he  does  not  run  characters 
together . 

3.  the  Tab  (<TAB>)  or  Ctrl-I  key.  This  key  causes  the 
cursor  to  tab  to  the  next  tab  stop.  As  the  cursor  is  tabbing, 
spaces  are  copied  into  the  input  line  buffer.  The  tab  stops  are 
set  by  the  TABS  command,  which  is  discussed  in  detail  in  Appendix 
I. 

4.  the  Backspace  (<BS>)  or  Ctrl-H  key.  This  key  allows  the 
user  the  delete  the  last  character  he  typed.  It  echoes  as  the 
cursor  backing  up  to  the  previous  position,  and  it  is  designed  to 
be  used  with  output  devices  which  perform  this  function  when  they 
receive  the  ASCII  code  for  a  backspace.  For  example,  if  the  user 
typed  "ABCD<BS>",  only  "ABC”  is  in  the  input  line  buffer;  the  "D" 
has  been  deleted.  If  <BS>  is  typed  again,  the  "C"  is  deleted, 
and  so  on.  The  user  cannot  delete  beyond  the  beginning  of  the 
line;  if  he  attempts  to  do  this,  an  <ESC>  is  processed,  echoing 
as  a  "$"  <CR> . 

5.  the  Delete  (<DEL>)  or  Rubout  key.  This  key  performs  the 
same  function  that  Backspace  does,  but  it  echoes  differently. 

The  deleted  characters  are  enclosed  in  backslashes.  For 
instance,  if  the  user  typed  "ABCD<DEL>E" ,  this  would  be  echoed 
onto  the  principal  I/O  device  as  "ABCD\D\E",  indicating  that  the 
"D"  was  deleted  and  the  string  in  the  input  line  buffer  is 
"ABCE".  If  the  user  types  more  than  one  <DEL>  in  a  row,  all  the 
deleted  characters  are  enclosed  in  one  set  of  backslashes.  For 
example,  if  the  user  types  "ABCDE<DEL><DELXDEL>ABE<DEL>C",  this 
will  appear  on  his  terminal  as  "ABCDE\EDC\ABE\E\C" ,  indicating 
that  "EDC"  and  then  "E"  were  deleted  and  the  resulting  string  is’ 

"ABABC".  This  feature  is  provided  to  permit  ease  in  the  use  of 
an  I/O  device  that  does  not  have  a  hardware  backspace  feature. 

6.  the  Carriage  Return  (<CR>)  key.  The  <CR>  key  always 
instructs  the  input  line  editor  to  terminate  the  input  of  the 
line  and  give  the  line  to  the  calling  program  (ARIAN  II)  to 
interpret. 

The  input  line  editor  is  an  extremely  useful  tool,  and  with  practice  it 
will  soon  become  a  very  easy  and  natural  tool  to  use. 
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4  The  ARIAN  II  Command 

The  fourth  section  of  the  ARIAN  II  Executive  is  the  command  line  parser. 
This  subroutine  breaks  apart  the  command  line  into  its  various  components  and 
stores  each  element  of  the  command  in  its  appropriate  internal  buffers. 

The  ARIAN  II  Command  is  divided  into  five  basic  divisions: 

1 .  the  name  of  the  command , 

2.  up  to  three  "special”  characters 
following  the  name  of  the  command, 

3.  the  name  of  a  file  or  symbol, 

4.  one  or  two  strings,  and 

5.  up  to  three  decimal  or  hexadecimal 
numeric  arguments. 

Only  the  first  element  is  required,  and  any  number  of  the  rest  of  the 
elements  are  optional  depending  upon  the  nature  of  the  command  to  be  executed. 
These  elements,  however,  must  occur  in  the  order  specified;  that  is,  the  command 
name  must  be  first,  the  special  characters  next,  the  file  name  next,  etc. 
Fields  2,  3,  4,  and  5  are  separated  by  one  or  more  delimiters,  and  if  more  one 
numeric  argument  is  specified,  these  must  also  be  separated  by  delimiters.  If 
two  strings  are  specified,  they  may  optionally  be  separated  by  delimiters.  The 
delimiter  characters  in  ARIAN  II  and  spaces  and  commas;  these  may  be  used  as  one 
prefers  to  improve  readability. 

The  name  of  the  command  consists  of  from  one  to  four  alphanumeric 
characters,  the  first  of  which  must  be  alphabetic.  There  is  one  special  case  in 
which  the  command  is  a  line  number,  and,  in  this  case,  the  other  fields  don't 
exist  and  the  text  which  follows  the  line  number  is  a  space  followed  by  the  text 
of  the  line  (see  Appendix  I). 

The  special  characters  are  options  pertaining  to  the  individual  commands. 
If  special  characters  are  used,  the  command  name  must  consist  of  exactly  four 
characters.  These  special  characters  then  appear  as  the  5th,  6th,  and  7th 
characters  of  a  string.  The  ARIAN  II  commands  look  for  these  characters 
specifically,  and  if  the  special  characters  typed  do  not  match  those  recognized 
by  the  command  they  are  simply  ignored. 

The  file  name  is  a  string  of  from  one  to  eight  alphanumeric  characters,  the 
first  of  which  must  be  alphabetic.  It  is  separated  from  the  command  name  and 
its  special  characters  by  one  or  more  delimiters. 

The  strings  are  vectors  of  characters  enclosed  in  double  quotes  (").  If 
two  strings  are  specified  they  need  not  be  separated  by  any  delimiters;  the 
double  quotes  which  close  the  first  string  and  open  the  second  serve  this 
purpose.  An  escape  character  is  provided  by  the  ARIAN  II  Command  Parser  to 
permit  the  user  to  specify  a  double  quote  as  part  of  a  string;  this  is  the 
backslash  (\).  The  backslash  instructs  the  parser  to  interpret  the  following 
character  literally,  so  \"  translates  into  one  double  quote  and  \\  translates 
into  cne  backslash.  If  there  are  not  more  characters  following  the  last  string 
in  the  command  line,  it  need  not  be  terminated  by  a  double  quote;  the  <CR>  which 
terminates  the  line  is  sufficient. 

The  numeric  arguments  consist  of  from  one  to  five  decimal  and  hexadecimal 
digits,  the  first  of  which  must  be  decimal.  The  arguments  are  separated  by  one 
or  more  delimiters. 

To  facilitate  ease  of  use  in  text  processing  applications,  the  alphabetic 
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characters  in  the  command  name,  the  special  characters,  the  file  name,  and  the 
numeric  arguments  are  converted  internally  to  upper  case  by  the  ARIAN  II  Command 
Parser.  Therefore,  the  user  may  enter  his  commands  in  either  upper-  or 
lower-case,  and  they  will  be  interpreted  in  upper-case.  Of  course,  no 
translation  is  done  on  the  contents  of  the  strings.  See  Appendix  I  for  a 
detailed  description  of  the  ARIAN  II  Command  in  SDL. 

A  command  line  beginning  with  an  asterisk,  semicolon,  blank,  or  any  ASCII 
character  less  in  value  than  the  character  for  zero  is  considered  to  be  a 
comment  and  is  not  processed  by  ARIAN  II.  Upon  encountering  such  a  character, 
the  Executive  loops  back  upon  itself  and  prepares  to  receive  the  next  command 
line. 


5  The  ARIAN  II  Command  Levels 

After  receipt  of  a  command  from  the  parser,  ARIAN  II  then  searches  through 
up  to  three  directories  of  commands  for  the  specified  command.  These  are  called 
Command  Levels,  and  are  named  Command  Level  1,  Command  Level  2,  and  Command 
Level  3,  in  the  order  they  are  searched.  The  specified  command  is  searched  for 
at  Command  Level  1  first  and  Command  Level  3  last. 

Command  Level  2  contains  the  ARIAN  II  Executive,  or  resident,  commands. 
They  are  discussed  in  detail  in  Appendix  I.  These  commands  provide  the  basic 
control,  file  editing  and  manipulation,  utility,  and  debug  facilities  of  ARIAN 
II. 

Command  Level  1  is  the  Customized,  or  user-defined,  command  level  of  ARIAN 
II.  These  are  created  by  the  CUST  Level  2  command,  and  it  allows  the  user  to 
specify  the  name  of  a  command  and  its  execution  address  in  memory.  This  is  a 
particularly  useful  feature,  and  the  user  can  employ  this  to  quickly  and  with  a 
minimum  of  effort  execute  test  programs  or  override  any  Level  2  command.  The 
command  itself  can  take  the  form  of  a  simple  subroutine,  and  is  therefor*  very 
easy  to  create.  Refer  to  Appendix  I  and  the  chapter  on  Level  1  and  Level  3 
commands  for  more  information. 

Command  Level  3  is  the  disk-resident  command  level.  Again  taking  the  form 
of  simple  subroutines,  these  commands  reside  as  files  on  disk  and  are  loaded-  and 
executed  by  ARIAN  II. 

When  ARIAN  II  receives  a  command,  it  first  searches  through  the  Level  1 
directory.  If  it  is  found,  it  is  executed  and  control  is  returned  to  ARIAN  II. 
If  it  is  not  found,  ARIAN  II  then  searches  through  the  Level  2  directory. 
Again,  if  it  is  found,  it  is  executed  and  control  is  returned  to  ARIAN  II. 

If  the  command  is  not  found  at  Level  2,  ARIAN  II  checks  to  see  if  Level  3 
is  engaged.  If  not,  an  error  message  is  given  and  control  is  returned  to  ARIAN 
II.  If  so,  ARIAN  II  loads  the  directory  of  the  Command  Drive  and  searches  it 
for  the  command  file.  If  found,  this  file  is  loaded  at  its  execution  address, 
executed,  and  control  is  returned  to  ARIAN  II.  If  it  is  not  found,  an 
appropriate  error  message  is  given  and  control  is  returned  to  ARIAN  II. 

Level  3  files  are  binary  files.  Their  directory  entries  contain  the  name 
of  the  command  with  a  ".CMD"  extension,  like  "NAME.CMD",  and  an  execution 
address.  Refer  to  the  chapter  on  Level  1  and  Level  3  commands  for  more 
information. 
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CHAPTER  3 

The  ARIAN  II  FILE  SYSTEMS 


ARIAN  II  supports  three  types  of  files  —  local  text  files,  local  binary 
files,  and  disk  files  (both  text  and  binary).  This  chapter  describes  the 
techniques  for  creating  and  manipulating  files  in  these  three  systems  and  the 
characteristics  of  files  in  these  three  systems. 

Local  files  are  memory-resident,  while  disk  files  reside  on  disk.  ARIAN  II 
maintains  two  local  file  directories  which  are  used  to  assist  the  memory  manager 
in  its  function  of  monitoring  and  controlling  the  use  of  memory  in  the  ARIAN  II 
environment  and  the  user  in  identifying  his  resident  files.  Each  disk  also 
contains  a  directory  of  its  files,  and  this  directory  is  loaded  into  memory  and 
analyzed  whenever  a  file  is  transferred  to  or  from  disk. 

The  ARIAN  II  user  may  create  up  to  ten  local  text  files  and  ten  local 
binary  files.  Each  disk  is  capable  of  holding  up  to  6^4  disk  files.  ARIAN  II 
partitions  memory  for  various  functions,  and  the  ARIAN  II  workspace  is  the 
partition  of  memory  within  which  the  local  text  files  reside.  Binary  files  may 
exist  anywhere  within  the  address  space,  as  may  Level  3  command  files.  Most 
Level  3  command  files,  however,  load  and  execute  in  the  transient  program  area 
(refer  to  the  chapter  on  Level  1  and  Level  3  commands). 


1  Local  Text  Files 

The  local  text  files  are  structured  organizations  of  the  user's  text  which 
reside  in  memory.  They  consist  of  lines  of  text  and  are  terminated  by  an 
end-of-file  mark.  Each  line  consists  of  a  four-digit  line  number,  a  space,  and 
the  text  of  the  line.  Transparent  to  the  user,  each  line  also  contains  some 
diagnostic  information  which  helps  ARIAN  II  determine  as  to  the  validity  of  the 
file. 

One  of  the  local  text  files  is  designated  as  the  primary  file,  while  the 
others  are  referred  to  as  secondary  files.  The  primary  file  is  the  file  which 
is  currently  being  referenced  by  the  user.  The  file  and  line  editing  commands, 
as  well  as  the  disk  transfer  commands,  operate  on  the  primary  file.  The 
secondary  files  reside  in  memory  for  the  purpose  of  later  being  included  in  the 
primary  file  or  being  designated  as  the  primary  file. 

When  a  local  file  is  created,  it  is  automatically  made  primary.  ARIAN  II 
can  create  local  text  files  in  a  number  of  ways,  but  the  most  common  way  to 
initially  create  a  local  text  file  is  by  using  the  FILE  command.  ''FILE 
FILENAME”  will  create  a  local  text  file  starting  at  a  memory  location  selected 
by  the  memory  manager  and  make  it  primary.  Once  created,  the  common  way  of 
entering  information  into  this  file  is  by  using  the  "APND"  command.  APND 
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appends  the  following  block  of  lines,  entered  in  Block  Line  Entry  Mode,  to  the 
end  of  the  current  primary  file,  or,  if  a  line  number  is  specified,  after  the 
given  line.  The  Block  Line  Entry  Mode  is  terminated  by  the  escape  sequence 
consisting  of  a  Ctrl-C  followed  by  a  <CR>.  Upon  exiting  this  mode,  ARIAN  II 
automatically  renumbers  the  file  starting  at  5  and  incrementing  by  5  unless  the 
N  option  is  used  C'APNDN"),  in  which  case  each  line  in  the  appended  block  begins 
with  the  specified  line  number  or  9999  if  the  no  line  number  was  given. 

The  primary  file  editing  commands,  namely  <lnum>,  APND,  DEL,  EDIT,  FIND, 
ISRT,  and  RNUM,  make  up  the  resident  file  editor  of  ARIAN  II.  ISRT,  or  insert, 
is  the  same  as  APND,  but  it  inserts  the  block  of  lines  before  the  specified 
line.  DEL  is  used  to  delete  one  line  or  a  block  of  lines,  <lnum>  is  used  to 
enter  a  line  directly  by  typing  a  1-4  digit  line  number  followed  by  a  space  and 
the  text  of  the  line,  EDIT  is  the  intra-line  editor,  FIND  is  used  to  search  for 
a  specified  string  in  the  primary  file,  and  RNUM  renumbers  the  primary  file. 

All  of  these  commands  make  the  resident  primary  file  editing  facility  of 
ARIAN  II  very  responsive  to  the  user.  He  may  intermix  these  commands  with  the 
other  system  commands  at  his  discretion. 

For  example,  the  following  illustrates  the  use  of  some  of  these  primary 
file  editing  commands.  This  is  not  a  precise  example;  all  ARIAN  responses  are 
in  lower  case  and  user  entries  are  in  upper  case.  Refer  to  the  sample  session 
for  more  detailed  and  precise  examples. 


01>FILE  TEST 

test  2a00  2a00 

01>APND 

?THE  RAIN  IN  SPAIN 

7FALLS  MAINLY 

?0N  SUNDAY  THROUGH  MONDAY 

?0N  ODD  WEEKDAYS 

?IN  THE  PLAIN. 

?~C 

01>LIST 

0005  the  rain  in  Spain 

0010  falls  mainly 

0015  on  Sunday  through  monday 

0020  on  odd  weekdays 

0025  in  the  plain. 

01>DEL  15,20 
01>LIST 

0005  the  rain  in  Spain 
0010  falls  mainly 
0025  in  the  plain. 

01>RNUM 

01>LIST 

0005  the  rain  in  Spain 
0010  falls  mainly 
0015  in  the  plain. 

01>FIND  "SP 

0005  the  rain  in  Spain 

01>LIST  15 

0015  in  the  plain. 

01>RNUM  10,10 
01>LIST 

0010  the  rain  in  spain 
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0020  falls  mainly 
0030  in  the  plain. 

01 >25  WHEN  IT. WISHES 
01>LIST 

0010  the  rain  in  spain 
0020  falls  mainly 
0025  when  it  wishes 
0030  in  the  plain. 

01> 

As  the  user  can  see,  the  resident  primary  file  editor  of  ARIAN  II  is  quite 
versatile.  There  are  also  a  number  of  Level  3  commands  which  supplement  this 
editor,  but  they  will  be  discussed  later.  Also,  not  every  aspect  of  these 
commands  has  been  discussed.  Each  command  has  several  forms  with  several 
options,  and  Appendix  I  discusses  them  at  some  length. 

The  EDIT  command  invokes  an  intra-line  editor  which  can  be  used  to  change 
the  contents  of  a  line  of  the  primary  file  without  retyping  the  entire  line.  It 
contains  subcommands  which  permit  the  user  to  delete,  replace,  and  insert 
characters  into  the  line.  EDIT  is  discussed  in  much  greater  detail  in  Appendix 
I. 


2  Local  Binary  Files 

The  local  binary  files  are  unstructured  organizations  of  programs  and  data 
which  reside  in  memory.  They  are  defined  solely  by  their  entries  in  the  local 
binary  file  directory,  and  this  entry  only  provides  information  as  to  the  name 
of  the  file  and  the  range  of  memory  over  which  it  exists.  The  memory  managers 
of  ARIAN  II  totally  ignore  the  entries  in  the  binary  file  directory,  and  these 
files  are  subject  to  destruction  by  the  memory  managers. 

For  this  reason,  it  is  recommended  that  the  user  create  all  binary  files 
outside  the  local  text  file  workspace  and  transient  program  areas  of  ARIAN  II. 
Also,  by  realizing  that  the  local  text  files  in  the  ARIAN  II  workspace  grow 
upward  in  memory,  the  user  may  judiciously  create  his  binary  files  in  the  upper 
regions  of  the  workspace.  This,  of  course,  must  be  done  with  care  and 
consideration  of  his  future  actions  in  the  system. 

Local  binary  files  are  created  in  one  of  three  ways:  (1)  implicitly  when 
ASSM  is  used  with  a  file  name  specification,  (2)  implicitly  when  a  binary  file 
is  loaded  from  disk,  and  (3)  explicitly  by  the  user  via  the  FILEB  option  of  the 
FILE  command.  When  created  by  the  assembler,  the  binary  file  is  defined  to 
exist  in  the  space  of  memory  covered  by  the  assembly  from  the  last  0RG  or  the 
entire  assembly  range  if  no  ORG  is  specified  within  the  assembled  file.  The 
LDIRB  command  lists  all  the  binary  files,  and  the  first  line  of  this  directory 
listing  gives  this  range  as  two  hexadecimal  numbers.  When  created  by  the  LOAD 
command,  the  binary  file  has  a  range  of  an  integral  number  of  blocks.  It  starts 
at  the  load  address  of  the  file  and  extends  over  the  size  of  the  file  as  it 
resides  on  disk.  Finally,  when  created  explicitly,  the  binary  file  has  exactly 
the  range  specified  by  the  user. 

No  management  is  done  of  the  binary  files  by  ARIAN  II.  These  files  are 
referenced  solely  for  the  convenience  of  the  user,  and  it  is  up  to  him  to  use 
them  at  his  discretion. 
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3  Local  File  Manipulation 

A  number  of  Executive  commands  are  available  through  ARIAN  II  which 
manipulate,  either  directly  or  indirectly,  the  local  files  and  provide 
information  to  the  user  on  their  validity. 

Two  commands,  FCHK  and  RCVR,  apply  only  to  local  text  files.  FCHK  is  used 
to  determine  the  validity  of  a  local  text  file.  Employing  the  inherent 
structure  of  the  ARIAN  II  text  file,  FCHK  insures  that  the  specific  data  of  each 
line  of  the  specified  or  implied  file  is  valid.  FCHK  with  no  argument  validates 
the  primary  file,  and  FCHK  FILENAME  validates  the  specified  local  text  file 
without  affecting  the  status  of  the  other  files.  The  other  command,  RCVR,  is 
used  to  attempt  to  recover  a  local  text  file  that  has  been  deleted  from  the 
local  text  file  directory.  It  uses  the  inherent  structure  of  the  ARIAN  II  text 
files  to  attempt  to  determine  the  bounds  and  other  pertinent  information  on  the 
data  starting  at  the  address  specified  by  the  command  in  an  attempt  to  rebuild 
the  directory  entry.  If  the  file  is  found  to  be  intact  up  to  its  end-of-file 
mark,  a  directory  entry  is  created.  The  format  of  this  command  is  RCVR  FILENAME 
ADDRESS,  where  FILENAME  is  the  new  name  of  the  file  to  be  recovered  and  ADDRESS 
is  the  starting  address  from  which  to  attempt  the  recovery. 

The  rest  of  the  commands  are  similar  in  structural  format.  They  are  FILE, 
LDEL,  LDIR,  LNAM,  and  LSCR.  Each  command  as  given  operates  on  the  local  text 
files,  while  FILEB,  LDELB,  LDIRB,  LNAMB,  and  LSCRB  operate  on  the  local  binary 
files. 

The  FILE  command  is  used  to  create  local  files,  and,  in  the  case  of  text 
files,  it  can  also  specify  the  bounds  and  name  of  the  current  primary  file. 
LDEL  deletes  the  specified  local  file,  and  LSCR  scratches  (deletes  all  the  files 
in)  the  specified  local  directory.  In  the  cases  of  LDEL  and  LSCR,  only  the 
directory  entries  are  affected;  note  that  RCVR  may  be  used  to  restore  the 
deleted  text  files.  LDIR  lists  the  contents  of  the  specified  local  directory, 
and,  finally,  LNAM  is  used  to  rename  the  specified  local  file. 


Disk  Files 

Disk  files  are  files  which  reside  on  disk;  they  may  be  either  text  (type  0) 
or  binary  (type  1).  All  disks  contain  directories  which  define  the  files 
contained  on  them,  and  these  directories  provide  the  only  direct  means  of 
definition  of  such  files.  The  directory  entries  contain  the  name  of  the  file, 
its  size  in  256-byte  blocks,  its  type,  its  starting  disk  address,  and,  if  it  is 
a  binary  file,  its  execution/load  address. 

The  files  themselves  are  organized  collections  of  data  stored  in  sequential 
256-byte  blocks  on  disk.  They  contain  no  particular  distinguishing  features, 
except  for  text  files,  whose  internal  organization  is  exactly  the  same  as  local 
text  files.  All  disk  files  are  loaded  and  stored  sequentially  to  and  from 
memory. 

For  this  purpose,  ARIAN  II  supports  the  LOAD  and  SAVE  commands.  LOAD  will 
load  the  specified  disk  file  into  memory  and  make  the  appropriate  entry  in 
either  the  local  text  or  binary  file  directory.  SAVE  will  save  the  current 
primary  file  on  disk  under  the  name  specified,  and  SAVEB  will  create  and  store  a 
binary  file  on  disk. 

In  addition  to  the  LOAD  and  SAVE  commands,  ARIAN  II  supports  three 
Executive  commands  which  perform  functions  similar  to  LDEL,  LDIR,  and  LNAM,  but 
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they  operate  on  disk  files.  These  commands  are  DDEL,  DDIR,  and  DNAM.  DDEL 
deletes  the  specified  disk  file's  directory  entry,  DDIR  displays  the  disk  file 
directory,  and  DNAM  renames  the  specified  disk  file. 

As  with  LOAD  and  SAVE,  DDEL,  DDIR,  and  DNAM  operate  on  the  Logged-in  drive. 
As  mentioned  earlier,  the  number  of  the  Logged-in  drive  is  specified  as  the 
second  digit  of  the  ARIAN  II  prompt.  As  with  all  ARIAN  II  Executive  commands, 
refer  to  Appendix  I  for  a  detailed  description  of  their  function. 

The  following  are  examples  of  the  use  of  some  of  the  ARIAN  II  commands 
discussed  in  this  chapter.  Again,  refer  to  Appendix  I  for  more  information  on 
these  commands.  The  upper /lower  case  conventions  of  user /ARIAN  II  apply  as 
before. 


01>DDIR 

fdos  10  1  2000 

arain2  60  0 

01>LDIR 

test  2a00  2a6b 

01>LNAME  TEST 
new  name?  TEST1 
01>FILE 

testl  2a00  2a6b 

01>LDIRB 
b800  b85a 
01>SAVE  IT 
$  file  saved 
01>DDIR 

fdos  10  1  2000 

arian2  60  0 

it  1  0 

01>DDEL  IT 
01>DDIR 

fdos  10  1  2000 

arian2  60  0 

01>LSCR 
01>LDIR 
01>LDIRB 
b800  b85a 
01> 


sdl 

arian3 


0050 


0050 


sdl 

arian3 


sdl 

arian3 


44  0 
50  0 


44  0 
50  0 


44  0 
50  0 
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CHAPTER  4 

LEVEL  1  and  LEVEL  3  COMMANDS 


Command  Levels  1  and  3  are  quite  similar  in  many  respects.  The  commands  in 
these  levels  take  the  form  of  subroutines,  i.e.,  they  are  usually  bodies  of  code 
ending  in  a  RET  instruction.  They  are  memory-resident  during  execution. 
Finally,  they  may  take  advantage  of  the  various  entry  points  into  ARIAN  II  and 
use  the  assembler-defined  symbols. 


1  Command  Level  1 

Command  Level  1  is  the  customized  command  level.  These  commands,  which  are 
created  by  the  CUST  Executive  command,  are  memory-resident  and  are  defined  only 
by  their  entries  in  the  Customized  Command  Table.  These  table  entries  consist 
of  the  name  of  the  command  (1  to  4  characters,  the  first  of  which  must  be 
alphabetic)  and  the  execution  address  of  the  command. 

Customized  commands  are  created  by  the  CUST  <cname>  <hadr>?  variant  of  the 
CUSTomize  command.  The  subroutine  starting  at  the  specified  or  implied  address 
becomes  the  new  command,  and,  until  the  user  deletes  this  customized  command, 
whenever  he  types  the  command  name  given,  he  will  execute  this  subroutine.  If 
no  address  is  specified,  the  default  execution  address  is  used  to  define  the 
starting  address  of  the  command. 

Examples  of  the  use  of  the  CUST  command  are: 


CUST  LIST 

The  LIST  Executive  Command  of  ARIAN  II  is  redefined, 
and  the  user  will  execute  the  subroutine  starting  at  the 
default  address  whenever  he  types  "LIST". 


CUSTD  LIST 

The  user-defined  LIST  command  is  deleted,  and  the 
normal  system  LIST  command  is  restored. 


CUST  TEST  6C00 

A  new  customized  command  called  TEST  is  created;  its 
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execution  starts  at  location  6C00  hexadecimal. 


CUSTL 

All  the  customized  commands  defined  by  the  user  that 
are  currently  in  effect  are  listed  with  their  execution 
addresses. 


CUSTS 

All  customized  commands  are  scratched  (deleted). 


2  Command  Level  3 

The  Level  3,  or  disk-resident,  commands  take  the  same  form  as  the  Level  1 
commands,  but  they  are  loaded  from  disk  when  their  command  name  is  given.  They 
reside  on  disk  as  binary  (type  1)  files  whose  names  consist  of  the  four 
characters  of  the  command  name  followed  by  ".CMD",  like  "HELP.CMD".  The  load 
address  in  their  disk  directory  entries  specifies  the  memory  location  at  which 
they  are  loaded  and  executed. 

Level  3  commands  may  execute  anywhere  in  memory,  but  ARIAN  II  has  reserved 
an  area  of  memory  for  these  commands.  It  is  called  the  transient  program  area, 
and  it  is  the  IK  section  of  memory  which  starts  at  IK  above  the  end  of  the  ARIAN 
II  workspace;  it  usually  starts  at  BCOO  hexadecimal.  Most  Level  3  system 
commands  execute  in  the  transient  program  area,  but  there  are  exceptions.  It  is 
recommended  that  the  user  assemble  all  his  Level  3  commands  to  execute  in  this 
region. 

Like  Level  1  commands,  Level  3  commands  can  be  created  by  creating  a  file 
of  the  program  and  assembling  it  (by  using  ASSM  0BC00  —  see  the  chapter  on  the 
assembler).  The  assembler  will  give  the  assembly  limits  specified  by  the  last 
ORG  and  the  end  of  the  program,  and,  if  these  are  the  actual  limits  of  the 
program,  the  user  can  save  it  on  disk  as  a  Level  3  command  by  issuing  the  SAVEB 
command,  like  "SAVEB  NAME.CMD  0BC00  OBDEF".  This  will  save  the  binary  of  the 
command  on  the  logged  in  drive.  To  execute  the  command,  the  user  should  ensure 
that  this  drive  is  made  the  command  drive  and  then  type  the  name  of  the  command, 
"NAME".  It  will  then  be  loaded  at  its  load  address  (BCOO  hexadecimal  in  this 
case)  and  executed. 


3  Interfacing  Level  1  and  Level  3  Commands  to  ARIAN  II 

In  order  to  interface  Level  1  and  Level  3  commands  to  ARIAN  II,  the  user 
must  understand  how  ARIAN  II  parses  commands.  Commands  are  parsed  into  several 
distinct  subfields,  as  mentioned  earlier,  and  the  elements  of  these  subfields 
are  stored  in  specified  buffers  within  the  ARIAN  II  scratchpad  RAM  area.  All 
commands  start  with  a  command  name  followed  by  up  to  three  special  characters 
and  any  number  of  arbitrary  characters.  The  command  name  is  always  interpreted 
as  being  four  characters  long,  with  unspecified  characters  being  spaces.  It  is 
converted  to  upper-case  letters  and  placed  in  the  four-byte  buffer  CBUF  by  the 
parser.  The  special  characters  are  placed  in  the  three  one-byte  buffers, 
SPCHR1 ,  SPCHR2 ,  and  SPCHR3,  which  immediately  follow  CBUF. 

The  second  command  subfield  is  a  file  or  command  name.  This  field  consists 
of  up  to  eight  characters,  the  first  of  which  must  be  alphabetic.  It,  too,  is 
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internally  capitalized  by  the  parser.  This  field  is  stored  in  FBUF,  left 
justified  and  blank-filled  on  the  right.  If  no  element  appears  in  this  field, 
FBUF  will  contain  only  binary  zeroes  (0  hexadecimal). 

The  third  command  subfield  consists  of  the  two  strings.  Each  string  may 
consist  of  up  to  40  characters,  and  they  are  stored  in  SBUF1  and  SBUF2.  No 
upper-case  conversion  is  done  to  string  fields.  If  a  string  is  stored  in  ore  of 
the  string  buffers,  the  first  character  of  the  buffer  will  be  a  double  quote  ard 
the  string  is  terminated  by  a  carriage  return  character  (0D  hexadecimal).  The 
ARIAN  II  parser  permits  the  first  string  to  be  over  40  characters,  in  which  case 
it  will  run  into  the  second  string  buffer.  In  this  case,  there  must  be  no 
second  string,  or  the  first  string  will  be  truncated. 

The  fourth  command  subfield  is  the  numeric  argument  field.  This  field 
consists  of  from  one  to  three  numbers.  The  arguments  parsed  in  this  field  are 
placed  in  ABUF  (four  ASCII  characters  per  argument)  and  BBUF  (two  bytes  per 
value).  ABUF  contains  the  ASCII  characters  of  the  numbers  in  groups  of  four 
(i.e.,  ABUF  to  ABUF+3  contains  the  first  number,  ABUF+4  to  ABUF+7  contains  the 
second,  and  ABUF+8  to  ABUF+11  contains  the  third);  if  the  numbers  contain  more 
than  four  digits,  only  the  first  four  are  contained  in  these  fields,,  and  if  they 
contain  less  than  four  digits,  these  fields  are  left-filled  (normalized)  with 
the  character  for  zero.  BBUF  contains  their  values,  assuming  they  are 
hexadecimal  numbers,  in  groups  of  two  (i.e.,  BBUF 'Snd  BBUF+1  contain  the  first 
value  in  the  INTEL-standard  low-order/high-order  format,  BBUF+2  and  BBUF+3 
contain  the  second,  and  BBUF+4  and  BBUF+5  contain  the  third).  If  there  are 
fewer  than  three  numeric  arguments  specified,  the  corresponding  ABUF  and  BBUF 
fields  will  contains  binary  zeroes  (0  hexadecimal). 

Hence,  with  the  arguments  of  a  customized  command  parsed  in  this  manner, 
the  user  can  create  customized  commands  which  perform  like  the  normal  ARIAN  II 
Executive  Commands.  ABUF  is  usually  used  to  contain  line  numbers  for  reference, 
BBUF  is  usually  used  to  contain  values  used  to  specify  hexadecimal  quantities, 
SBUF1  and  SBUF2  contain  the  strings,  FBUF  is  usually  used  to  contain  a  file  or 
command  name,  SPCHR2,  SPCHR2,  and  SPCHR3  contain  the  special  characters,  and 
CBUF  contains  the  command  name. 

The  entire  input  line,  as  a  consequence  of  the  input  line  editor,  is 
available  to  the  user  in  IBUF.  The  first  character  of  the  line  is  at  IBUF,  and 
the  line  ends  in  a  <CR>.  Location  IBUF-1  contains  a  count  of  the  number  of 
characters  in  the  line,  including  the  character  at  IBUF-1  and  the  ending  <CR>. 

The  following  are  examples  of  the  use  of  these  buffers.  Note  that  <null> 
refers  to  the  binary  zero  (0  hexadecimal),  and  <null>s  refer  to  the  number  of 

binary  zeroes  required  to  fill  the  specified  field. 

\ 

REGS  BC  2000 

CBUF  =  "REGS",  SPCHR1=SPCHR2=SPCHR3=<null>,  FBUF  = 

"BC"  and  6  blanks,  SBUF1=SBUF2=<null>s, 

ABUF ( 0- 3 ) = "2000" ,  ABUF(4-11)=<null>s,  BBUF(0)=0, 

BBUF( 1 ) =20  Hexadecimal,  BBUF(2-5)=<null>s 

xdirx  test 

CBUF  =  "XDIR",  SPCHR1="X",  SPCHR2=SPCHR3=<null>, 

FBUF  =  "TEST"  and  4  blanks,  and  the  rest  of  the  buffers 
contain  <null>s. 

savebl  test.cmd  OaOOO  OafeO 

CBUF  =  "SAVE",  SPCHR1="B",  SPCHR2="1", 

SPCHR3=<null>,  FBUF  =  "TEST.CMD",  SBUF1=SBUF2=<null>s, 
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ABUF(0-3)  =  "OAOO" ,  ABUF(4-7)  =  "OAFE", 

ABUF(8-11)=<null>s,  BBUF(O)  =  0  hex,  BBUF(1)  =  AO  hex, 

BBUF(2)  t  EO  hex,  BBUF(3)=  AF  hex,  and 
BBUF ( 4-5 ) =<null>s 

The  addresses  of  CBUF,  ABUF,  BBUF,  FBUF,  SPCHR1 ,  SPCHR2,  SPCHR3,  SBUF1 ,  and 
SBUF2  are  given  in  Appendix  II. 


4  ARIAN  II  Entry  Points 

Aside  from  using  a  simple  RET  instruction  to  return  to  ARIAN  II  from  a 
Level  1  or  Level  3  command,  ARIAN  II  has  three  reentry  locations  which  may  be 
branched  to  for  a  clean  return  to  the  system. 

These  reentry  points  are  at  memory  locations  0,  4,  and  66  hexadecimal. 
Location  0  is  the  ARIAN  II  dead  start  entry  point;  the  entire  ARIAN  II  system  is 
initialized  if  execution  begins  at  this  point.  Location  4  is  the  ARIAN  II  warm 
start  entry  point;  only  part  of  the  system  is  initialized  if  execution  begins  at 
this  point.  Finally,  location  66  hex  is  the  non-maskable  interrupt  entry  point. 
It  transfers  control  directly  to  the  ARIAN  II  Executive;  no  initialization  is 
done  if  the  user  enters  here.  Location  66H  is  also  referenced  by  the 
assembler-defined  symbol  ZEOR. 


5  Use  of  Restart  Locations  by  ARIAN  II 

Restarts  2,  3,  4,  5,  and  6  are  unused  by  ARIAN  II  and  are  free  for  the  user 
to  employ  at  his  discretion. 

Restart  0  is  used  for  the  dead  and  warm  restarts  of  ARIAN  II,  and  it  is 
recommended  that  it  not  be  used  for  any  other  purpose.  Restart  1  is  the  ARIAN 
II  breakpoint  reentry  restart,  and  it  may  be  employed  by  the  user  if  he  does  not 
wish  to  set  any  breakpoints  under  the  BREK  command.  Finally,  Restart  7  is  the 
ARIAN  II  memory  trap,  and  it,  too,  may  be  employed  by  the  user  at  his 
discretion.  This  memory  trap  is  a  safety  feature  to  halt  programs  which  attempt 
to  run  in  non-existant  memory. 


6  The  ARIAN  II  Jump  Table 

Appendix  II  also  summarizes  the  functions  supported  by  the  jump  table  in 
ARIAN  II.  Briefly,  this  jump  table  provides  easy  access  to  the  following 
routines  and  Executive  commands: 

1.  CKA11  -  check  for  the  presence  of  at  least  one 
numeric  argument.  Return  with  zero  set  if  no  numeric 
arguments,  clear  if  at  least  one. 

2.  CKA21  -  check  for  the  presence  of  at  least  two 
numeric  arguments.  Return  with  zero  set  if  two 
arguments  are  not  present,  clear  if  at  least  two  are 
present. 

3.  CKFN1  -  check  for  the  presence  of  an  argument 
in  FBUF.  Again,  zero  set  means  no  argument,  clear 
means  there  is  an  argument. 

4.  DSCAN  -  scan  logged  in  disk  directory  for  the 
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file  name  contained  in  FBUF.  If  found,  return  with 
zero  set  and  HL  pointing  to  the  first  byte  of  the 
directory  entry;  otherwise,  return  with  zero  clear. 

5.  FILE  -  execute  the  FILE  Executive  command. 
Arguments  are  passed  in  the  appropriate  buffers. 

6.  FIND  -  find  the  line  whose  number  is  contained 
in  ABUF  (normalized).  HL  point  to  the  first  byte  of 
the  line  upon  return.  Line  number  found  is  first  line 
greater  than  or  equal  to  the  number  in  ABUF. 

7.  LINE  -  execute  the  <lnum>  Executive  command. 
The  line  contained  in  IBUF  is  entered  into  the  primary 
file. 

8.  LOAD  -  execute  the  LOAD  executive  command. 
Arguments  are  passed  in  the  appropriate  buffers. 

9.  SAVE  -  execute  the  SAVE  executive  command. 
Arguments  are  passed  in  the  appropriate  buffers. 

10.  MESS  -  print  the  character  string  pointed  to 
by  HL  and  ending  in  <CR>  on  the  principal  I/O  device 
and  return  to  the  ARIAN  II  Executive.  This  routine  is 
good  for  printing  fatal  error  messages. 

1 1 .  FSEA  -  search  the  local  text  file  directory 
for  the  file  whose  name  is  in  FBUF.  A  number  of  flags 
are  set  by  this  entry;  see  Appendix  II.  Zero  flag  is 
clear  if  file  name  is  found,  set  if  not  found. 

12.  RNUM  -  execute  the  RNUM  executive  command. 
Arguments  are  passed  in  the  appropriate  buffers. 
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CHAPTER  5 

The  ARIAN  II  ASSEMBLER 


The  assembler  of  ARIAN  II  is  a  very  powerful  real-time  assembler  based  on 
the  INTEL-standard  mnemonics  for  the  8080  microprocessor.  The  assembler, 
however,  is  not  just  an  8080  assembler;  it  is  a  pseudo-Z80  assembler  which  gives 
the  user  the  ability  to  assemble  some  of  the  common  Z80  instructions  as  well  as 
all  of  the  8080  instructions. 

The  assembler  features  its  own  set  of  pseudo-ops  (most  of  which  are  similar 
to  the  INTEL-standard  pseudo-ops),  all  the  8080  mnemonics,  some  arithmetic 
operations  in  the  operand  field,  literal  character  definitions  in  the  operand 
field,  a  unique  set  of  Z80  instructions,  the  ability  to  explicitly  create  binary 
files,  and  manipulation  of  the  default  execution  address. 

The  standard  features  supported  by  the  assembler  include: 

1.  free-format  source  input, 

2.  symbolic  addressing,  including  forward  and 
relative  symbolic  references, 

3.  up  to  384  six-character  symbols, 

4.  reserved  names  for  the  registers  which  may  be 
redefined, 

5.  a  full  set  of  pseudo-ops,  including  default 
execution  address  control,  and 

6.  automatic  generation  of  a  symbol  table  which 
may  be  referenced  later. 


1  The  Assembler  in  General 

The  assembler  translates  the  lines  contained  in  the  primary  file  into 
cbject  code  residing  in  memory.  The  second  character  following  the  line  number 
is  the  first  source  code  character  position.  Therefore,  the  character 
immediately  following  the  line  number  should  be  a  space;  the  APND  and  ISRT 
commands  place  a  space  here  automatically,  and  the  user  need  only  be  concerned 
with  this  restriction  if  he  enters  his  own  lines  using  the  <lnum>  <text> 
command.  Line  numbers  are  not  processed  by  the  assembler;  they  are  merely 
reproduced  in  the  listing. 

The  assembler  will  assemble  a  source  program  file  composed  of  statements, 
oomments,  and  pseudo  operations  on  each  line.  It  does  this  in  two  passes. 
During  Pass  1,  the  assembler  allocates  all  storage  necessary  for  the  translated 
program  and  defines  the  values  of  all  symbols  used  by  creating  a  symbol  table. 
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The  storage  allocated  for  the  object  code  will  begin  at  the  byte  explicitly  or 
implicitly  specified  by  the  ASSM  command  unless  an  ORG  pseudo-op  is  present  in 
the  program.  Durifig  Pass  2,  all  expressions,  symbols,  and  ASCII  constants  are 
evaluated  and  placed  in  allocated  memory  in  the  appropriate  locations.  The 
listing,  also  produced  during  Pass  2,  indicates  exactly  what  data  is  in  each 
location  of  memory. 

Statements  contain  either  symbolic  ARIAN  II  assembly  language  instructions 
or  pseudo-ops.  These  statements  are  divided  into  up  to  four  fields:  (1)a  name 
field  (optional),  (2)  an  operation  field,  (3)  an  operand  field  (optional),  and 
W  a  comment  field  (optional).  If  the  first  valid  character  in  a  statement  is 
a  semicolon  or  asterisk,  the  entire  statement  is  processed  as  a  comment. 

The  name  field,  if  present,  must  begin  in  the  first  assembler  character 
position  in  the  input  line;  this  is  the  second  character  after  the  line  number. 
The  symbol  in  the  name  field  can  contain  as  many  characters  as  the  user  wishes, 
but  only  the  first  six  characters  are  used  in  the  symbol  table  to  uniquely 
define  the  symbol.  All  symbols  in  this  field  must  begin  with  an  alphabetic 
character  and  may  contain  no  special  characters.  Digits  are  allowed.  The  name 
field  may  or  may  not  be  terminated  by  a  colon,  at  the  user's  discretion. 

The  operation  field  contains  either  an  ARIAN  II  assembler  operation 
imemonic  or  a  system  pseudo-op.  The  ARIAN  II  assembler  operation  mnemonics  and 
system  pseudo-ops  are  described  below.  The  operation  field  is  separated  from 
the  name  field  by  one  or  more  blanks;  if  no  name  field  is  present,  it  begins  in 
or  after  the  third  character  position  after  the  line  number  ''at  least  two  spaces 
in  front  of  it). 

The  operand  field  contains  parameters  pertaining  to  the  operation  in  the 
operation  field.  If  two  arguments  are  present,  they  must  be  separated  by  a 
comma.  The  operand  field  is  separated  from  the  operation  field  by  at  least  one 
space . 

The  comment  field  is  for  explanatory  remarks.  It  is  reproduced  in  the 
listing  without  processing.  Comment  lines  must  start  with  either  a  semicolon  or 
an  asterisk;  it  is  recommended  that  comments  at  the  aid  of  a  statement  also 
start  with  one  of  these  characters,  but  this  is  not  a  restriction  (comments 
after  the  operand  or  operation  field  may  or  may  not  start  with  a  semicolon  or 
asterisk). 

The  ARIAN  II  assembler  is  completely  free-format,  as  described  above,  but  a 
"standard"  ARIAN  II  assembler  program  line  format  is  defined  by  ARIAN  II  and  is 
recognized  by  various  options  of  several  commands.  This  format  is  as  follows: 

1.  the  name  field  must  start  in  the  first 
assembler  line  column, 

2.  if  the  name  field  exists,  the  operation  field 
starts  one  space  after  the  colon  or  end  of  the  name 
field;  if  the  name  field  does  not  exist,  the  operation 
field  starts  in  the  second  assembler  line  column, 

3.  the  operand  field  starts  one  space  after  the 
operation  field, 

4.  the  comment  field  starts  one  space  after  the 
•  operand  field  if  there  is  one  or  one  space  after  the 

operation  field  if  there  is  no  operand  field,  and  the 
comment  field  must  start  with  a  semicolon,  and 

5.  if  the  entire  line  is  a  comment,  it  must  start 
with  either  an  asterisk  or  a  semicolon  (asterisk 
preferred)  in  the  first  assembler  line  column. 
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Symbolic  names  and  addressing  are  also  supported  by  the  assembler.  To 
assign  a  symbolic  name  to  a  statement,  the  name  is  placed  in  the  name  field.  To 
leave  off  the  name- field,  the  user  skips  two  cr  more  spaces  after  the  line 
number  (one  or  more  spaces  in  block  line  entry  mode)  and  begins  the  operation 
field.  If  a  name  is  attached  to  a  statement,  the  assembler  assigns  it  the  value 
of  the  current  location  (program)  counter.  The  program  counter  holds  the 
address  of  the  next  byte  to  be  assembled  if  the  instruction  is  a  machine 
instruction  or  pseudo-op.  The  EQU  pseudo-op,  however,  assigns  to  its  label  a 
value  which  is  defined  in  the  operand  field.  Note:  do  not  confuse  the  location 
counter  of  the  assembler  with  the  "$"  symbol  discussed  later;  this  location 
counter  points  to  the  next  instruction  to  be  assembled,  while  points  to  the 
instruction  after  the  current  instruction  if  the  current  instruction  is  a  normal 
mnemonic  or  "$"  points  to  the  current  instruction  if  it  is  a  pseudo-op. 

Names  are  defined  when  they  appear  in  the  name,  or  label,  field.  All 
defined  names  may  be  used  as  symbolic  arguments  in  the  operand  field.  The 
reserved  system  symbols,  however,  are  defined  by  the  assembler  and  must  not  be 
redefined  by  the  user;  a  duplicate  label  error  will  result  if  this  is  done. 
These  reserved  system  symbols  are  discussed  later. 

In  addition  to  the  user-defined  and  system-defined  symbols,  the  assembler 
has  reserved  several  symbols  to  represent  the  registers  of  the  8080.  These 
symbols,  like  the  system  reserved  symbols,  may  only  be  used  in  the  operand 
field.  These  symbols  are: 

1.  A  —  the  accumulator;  value  7, 

2.  B,  C,  D,  E,  H,  and  L  —  the  B,  C,  D,  E,  H,  and 
L  registers;  values  0,  1,  2,  3,  and  5,  resp., 

3.  M  —  memory  (pointed  to  by  H&L);  value  6, 

4.  P,  PSW  —  the  program  status  word;  value  6, 
and 

5.  S,  SP  —  the  stack  pointer;  value  6. 

The  assembler  also  supports  relative  symbolic  addressing.  If  the  name  of  a 
particular  location  is  known,  a  nearby  location  may  be  specified  using  the  known 
name  and  a  numeric  offset.  All  defined  symbols,  including  "$",  may  be  used  in 
this  relative  symbolic  addressing  scheme. 

For  example,  LDA  $+5  loads  the  accumulator  with  the  value  of  the  byte 
located  five  bytes  after  the  beginning  of  the  next  instruction.  Also,  SSPD 
L0C-7  stores  the  value  of  the  stack  pointer  starting  at  the  byte  located  seven 
bytes  in  front  of  the  memory  location  pointed  to  by  the  symbol  "LOC". 

The  assembler  permits  the  user  to  write  positive  and  negative  numbers 
directly  in  a  statement.  They  will  be  regarded  as  integer  constants,  and  their 
binary  values  will  be  used  appropriately.  All  unsigned  numbers  are  considered 
to  be  positive.  Decimal  constants  can  be  defined  using  the  suffix  "D"  after  the 
numeric  value,  but  this  is  not  required  since  the  default  is  decimal.  Hence,  10 
and  10D  define  the  constant  ten  decimal.  Hexadecimal  constants  must  start  with 
a  digit  and  end  with  the  suffix  "H".  Examples  of  hexadecimal  constants  are  10H, 
OAFH,  00010 1H,  and  00BCH. 

ASCII  constants  may  be  defined  by  enclosing  the  ASCII  character  within 
single  quotes,  i.e.,  'C'.  Two  characters  may  be  enclosed  within  single  quotes 
for  double-word  constants. 
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2  Assembler  Pseudo-ops 

The  following  is  a  list  and  a  description  of  the  pseudo-ops  recognized  by 
the  assembler: 


1.  ASC  '<string>'  —  ASCII  string.  This  pseudo-op 
loads  consecutive  memory  locations  starting  at  the  current 
value  of  the  location  counter  with  the  ASCII  values  of  the 
characters  specified  in  the  string. 

2.  DB  <expression>  —  define  one  byte.  This 
instruction  evaluates  the  specified  operand  and  loads  one 
8-bit  value  into  the  location  pointed  to  by  the  location 
counter.  If  the  number  is  evaluated  into  a  16-bit  quantity, 
only  the  low-order  byte  is  loaded. 

3.  DS  <expression>  —  define  storage.  This  reserves 
the  specified  number  of  bytes  starting  at  the  current  value 
of  the  location  counter. 

4.  DW  <expression>  —  define  one  word.  This 
instruction  evaluates  the  specified  operand,  producing  a 
16-bit  value  which  it  loads  into  memory  (low  order,  high 
order)  at  the  location  pointed  to  by  the  location  counter 
and  the  succeeding  location. 

5.  END  —  end  the  assembly.  This  statement  is  not 
required;  assembly  will  stop  when  the  end  of  the  file  is 
reached  or  this  statement  is  encountered. 

6.  <label>  EQU  <expression>  —  the  specified  label  is 
assigned  the  computed  value  of  the  operand;  the  computed 
value  is  a  16-bit  quantity. 

7.  EXEC  <expression>  —  the  default  execution  address 
is  set  to  the  value  of  the  expression. 

8.  LST  —  turn  on  the  listing  of  the  assembly  of  the 
program  on  the  principal  I/O  device  if  it  is  not  already  on. 
This  can  be  used  to  list  only  selected  portions  of  a  program 
during  the  assembly. 

9.  NLST  —  turn  off  the  listing  of  the  assembly  of  the 
program. 

10.  ORG  <expression>  —  set  the  origin  (location 
counter)  to  the  specified  value.  This  instruction  also 
resets  the  assembly  limits  and  the  location  in  memory  at 
which  the  object  code  is  loaded.  If  an  ORG  appears  more 
than  one  time  in  the  program,  the  limits  set  by  the  last  ORG 
and  the  end  of  the  assembly  are  reflected  in  the  assembly 
limits  displayed  by  the  LDIRB  command. 

All  pseudo-ops  may  be  preceeded  by  a  label. 
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3  System  Reserved  Labels 

Another  feature  of  the  ARIAN  II  assembler  is  its  system  reserved  labels. 
These  symbols  provide  easy  access  to  a  host  of  utility  subroutines  for  functions 
such  as  I/O,  data  conversion,  and  ARIAN  entry  points,  and  they  also  supply  some 
commonly-used  buffer  and  variable  addresses.  All  system  reserved  symbols  start 
with  the  letter  ”Z"  and  are  at  most  four  characters  long. 

The  following  is  a  complete  list  of  the  ARIAN  II  assembler  reserved 
symbols.  They  are  described  in  detail  in  Appendix  III. 

Symbol  Function 


ZEOR  the  Executive  reentry  point  to  ARIAN  II 

ZLIN  the  ARIAN  II  input  line  editor 

ZINK  polls  the  principal  I/O  channel  for  an  <ESC> 

ZIN  input  one  character  from  principal  I/O  channel 

ZOUT  output  one  character  to  principal  I/O  channel 

ZCR  output  <CR>  <LF>  to  principal  I/O  channel 

ZARG  the  ARIAN  II  Executive  Parser 

ZHOT  display  the  A  register  as  two  hexadecimal  digits 

ZDOT  display  the  A  register  as  up  to  three  decimal  digits,  left  blank  fill 

ZBLK  output  space  to  principal  I/O  channel 

ZPRH  print  string  pointed  to  by  HL  ending  in  <CR>  on  principal  I/O  channel 

ZPPH  print  string  pointed  to  by  HL  ending  in  <CR>  on  printer 

ZPRR  print  string  pointed  to  by  return  address  ending  in  <null>  (0) 

ZPHL  print  HL  as  four  hexadecimal  digits 
ZSHD  compute  BC  =  HL  -  DE 

ZBOF  address  of  two-byte  buffer  which  contains  starting  location  of  primary  file 

ZEOF  address  of  two-byte  buffer  which  contains  ending  location  of  primary  file 

ZBBF  address  of  BBUF 

ZIBF  address  of  IBUF 

ZEN  exchange  nybbles  of  the  A  register 

ZCHA  convert  low  nybble  of  A  to  its  ASCII  hexadecimal  equivalent 
ZCAH  convert  ASCII  hexadecimal  character  in  A  to  its  binary  equivalent  in  A 
ZCRL  call  relative  long 

ZJRL  jump  relative  long 
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4  The  Standard  8080  Mnemonics 

The  ARIAN  II  assembler  recognizes  all  the  standard  8080  mnemonics.  For 
reference,  they  are: 


Miemonic 

Mnemonic 

ACI 

ADC 

ANA 

JUI 

CM 

CMA 

OJZ 

CP 

CPO 

cz 

DCR 

DCX 

HLT 

IN 

JC 

JM 

JNZ 

JP 

JZ 

LDA 

LX  I 

MVI 

ORA 

ORI 

POP 

PUSH 

RC 

RET 

RNC 

RNZ 

RPO 

RRC 

SBB 

SBI 

STA 

STAX 

SUI 

XCHG 

XTHL 

Mnemonic 

Mnemonic 

ADD 

ADI 

CALL 

CC 

CMP 

CNC 

CPE 

CPI 

DAA 

DAD 

DI 

El 

I  NR 

I  NX 

JMP 

JNC 

JPE 

JPO 

LDAX 

LHLD 

MOV 

NOP 

OUT 

PCHL 

RAL 

RAR 

RLC 

RM 

RP 

RPE 

RST 

RZ 

SHLD 

SPHL 

STC 

SUB 

XRA 

XRI 

'l 
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5  The  Special  Z80  Mnemonics 

The  following  is  a  list  of  the  special  Z80  mnemonics  recognized  by  the 
ARIAN  II  assembler  and  their  ZILOG  equivalents. 


Mnemonic  A  Operand 

ZILOG  Equiv 

Comments 

SSPD  <expression> 

LD  (nn) ,SP 

store  SP  direct 

LSPD  <expression> 

LD  SP, (nn) 

load  SP  direct 

SBCD  <expression> 

LD  (nn),BC 

store  BC  direct 

LBCD  <expression> 

LD  BC,(nn) 

load  BC  direct 

SDED  <expression> 

LD  (nn) ,DE 

store  DE  direct 

LDED  <expression> 

LD  DE,(nn) 

load  DE  direct 

EXA 

EX  AF , AF ' 

EXX 

EXX 

BR  <expression> 

JR  n 

branch  relative 

BC  <expression> 

JR  C,n 

branch  relative 

on 

carry 

BNC  <expression> 

JR  NC,n 

branch  relative 

on 

no  carry 

BZ  <expression> 

JR  Z,n 

branch  relative 

on 

zero 

BNZ  <expression> 

JR  NZ,n 

branch  relative 

on 

no  zero 

DBJ  <expression> 

DJNZ  n 

decrement  B  and 

branch  relative 

LD 

LDD 

LDR 

LDDR 

LI 

LDI 

LIR 

LDIR 

CD 

CPD 

CDR 

CPDR 

Cl 

CPI 

CIR 

CPIR 

NEG 

NEG 

RLD 

RLD 

RRD 

RRD 

SHB 

SBC  HL,BC 

SHD 

SBC  HL,DE 

SHS 

SBC  HL,SP 

AHB 

ADC  HL.BC 

AHD 

ADC  HL,DE 

AHS 

ADC  HL,SP 

IMO 

IM1 

IM2 


IM  0 
IM  1 
IM  2 
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ID 

IND 

IDR 

INDR 

II 

INI 

IIR 

INIR 

OD 

0UTD 

0DR 

0TDR 

01 

0UTI 

01 R 

0TIR 

CIN 

IN  A, (C) 

COT 

OUT  (C),A 

6  Operand  Evaluation 

Operand  evaluation  in  ARIAN  II  is  performed  from  left  to  right,  and  there 
is  no  operator  hierarchy.  Parenthesized  expressions  are  not  permitted.  All 
operations  performed  are  done  on  sixteen-bit  quantities,  and  all  operators  have 
both  an  infix  and  prefix  form,  the  prefix  form  being  the  same  as  the  infix  form 
with  the  first  operand  having  a  value  of  zero.  Single  character  strings  of  the 
form  '<char>'  are  permitted  in  expressions  and  stand-alone. 

The  operators  recognized  by  the  ARIAN  II  Assembler  are: 

+  —  addition 
-  —  subtraction 
&  —  logical  AND 
!  —  logical  OR 

%  —  logical  Exclusive  OR 

<  —  Extract  High  (add  operands,  exchange 
bytes,  and  zero  cut  high-order  byte) 

>  —  Extract  Low  (add  operands  and  zero  cut 
high-order  byte) 

*  —  multiplication 
/  —  division 

All  numeric  arguments  are  assumed  to  be  decimal  unless  the  suffix  "H"  is 
appended  to  them.  Therefore,  100  is  100  decimal  and  100H  is  100  hexadecimal. 

The  symbol  is  used  as  the  value  of  the  location  counter  for  the  next 
instruction.  In  normal  instrucions,  "$"  points  to  the  first  byte  of  the  next 
instruction;  in  pseudo-ops,  "$"  points  to  the  first  byte  of  the  pseudo-op.  This 
permits  relative  addressing  to  take  the  form  of  "BR  LABEL-$"  and  pseudo-ops  like 
"STACK  EQU  $"  to  be  used. 

Finally,  if  an  expression  with  a  value  greater  than  OFF  hexadecimal  is 
loaded  into  an  eight-bit  register,  like  "MVI  A,1FFH",  only  the  low-order  byte  of 
this  value  is  loaded. 

Examples  of  permitted  expressions  include: 

NCHRS*8 

<START 

SIZE/256+34- 12&0FFH!20H>0*2 

LABEL+3 

POINT-' A ’+60 
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POINTB-OAFH+6-2 

HERE-$-2 


7  Assembler  Error  Messages 

The  following  is  a  list  of  the  error  messages  produced  by  the  assembler  and 
their  meanings: 

Error  Meaning 


R  register  error.  The  register  name  is  missing  or  invalid. 

S  syntax  error.  The  instruction  syntax  is  incorrect. 

U  undefined  symbol.  The  referenced  symbol  is  incorrect. 

V  value  error.  The  computed  value  cannot  be  represented  as  a 
16-bit  value  or  the  instruction  has  a  syntax  error. 

M  missing  label  error.  A  required  label  is  missing. 

A  argument  error.  The  instruction's  argument  is  of  the  wrong 
type  or  generally  incorrect. 

L  label  error.  The  label  of  this  instruction  contains  an  invalid 
character. 

D  duplicate  label  error.  The  label  of  this  instruction  has  been 
defined  elsewhere. 

0  opcode  error.  The  opcode  (in  the  operation  field)  of  this 
instruction  is  invalid. 


<i 

r • 

'l 
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CHAPTER  6 

The  ARIAN  II  SUBSYSTEMS  —  TERMINAL  and  UTILITY 


ARIAN  II  supports  two  subsystems  of  commands  at  the  Executive  level;  they 
are  the  Terminal  subsystem,  invoked  by  the  TERM  command,  and  the  Utility 
subsystem,  invoked  by  the  UTIL  command.  Each  is  a  complete  subsystem;  they 
contain  their  own  argument  parsing  schemes  and  set  of  commands. 


1  The  Terminal  Subsystem 

The  TERMinal  command  invokes  the  Terminal,  or  inter-system  communication, 
subsystem  of  ARIAN  II.  Under  this  subsystem  the  microcomputer  becomes 
relatively  transparent  to  the  user,  and  the  user's  terminal  is  made  to  respond 
like  a  timesharing  terminal  to  an  external  computer  system.  Each  character 
typed  is  sent  to  a  modem  and  acoustic  coupler,  and  each  character  received  by 
the  modem  is  sent  to  the  user's  CRT. 

The  Terminal  subsystem  responds  to  three  commands.  They  are  Ctrl-A, 
Ctrl-L,  and  Ctrl-R.  Ctrl-A  invokes  the  terminal  alternate  command  set.  This 
command  set  consists  of  the  following  commands: 

1.  M  —  transfer  to  the  Monitor  Command  System 
(MCS) . 

2.  R  <hadr>  —  call  the  subroutine  located  at  the 
specified  address.  The  return  in  the  subroutine 
transfers  control  to  the  terminal  mode  (not  the 
terminal  alternate  command  set). 

3.  T  <hadr>  —  transfer  the  downloaded  code  to 
the  specified  address.  This  command  transmits  a  <CR> 
to  the  external  computer,  and  the  object  code 
downloaded  is  loaded  into  memory  starting  at  the 
specified  address.  The  addresses  given  in  the  code  are 
ignored,  and  the  entire  code  is  loaded  sequentially 
into  memory. 

4.  F  —  turn  off  echo;  full  duplex  mode  of 
operation 

5.  H  —  turn  on  echo;  half  duplex  mode  of 
operation  (default) 

6.  X  —  exit  to  terminal  mode. 

All  commands  in  the  terminal  alternate  command  set  are  parsed  like  MCS 
(Monitor  Command  System)  commands.  The  parser  scans  the  input  line  until  it 

4  Page  27 


The  ARIAN  II  User's  Manual 


encounters  a  non-blank  character;  this  character  is  interpreted  as  the  command 
name.  The  parser  then  scans  until  it  encounters  another  non-blank  character;  it 
then  interprets  the  string  starting  at  this  character  as  a  hexadecimal  number 
and  scans  until  it  encounters  an  invalid  hexadecimal  character.  Only  the  last 
four  characters  are  used  to  interpret  the  final  value.  If  fewer  than  four 
characters  are  in  the  number  then  the  number  is  zero  filled  from  the  left. 

Ctrl-L  is  the  download  command  to  the  terminal  mode  subsystem.  A  <CR>  is 
transmitted  to  the  external  computer,  and  the  object  code,  in  INTEL-standard 
format,  is  loaded  into  the  microcomputer's  memory  at  the  addresses  specified  in 
the  load  blocks.  Downloading  can  be  interrupted  at  any  time  by  typing  <ESC>  on 
the  principal  I/O  device  keyboard.  This  key  transfers  control  to  the  terminal 
mode  subsystem. 

Ctrl-R  simply  returns  control  to  the  program  which  called  the  terminal 
subsystem.  This  calling  program  is  usually  ARIAN  II. 

More  information  is  available  on  the  TERM  command  in  Appendix  I. 


2  The  Utility  Subsystem 

The  UTIL  command  invokes  the  Utility  subsystem.  This  subsystem  gives  the 
user  the  ability  to  examine  and  modify  memory  directly.  In  response  to  this 
command,  the  user  is  prompted  with  a  slash.  He  may  then  enter  any  of  the 
following  UTILity  commands: 

1.  C  <hadr>  <hadr>  <hadr>  —  copy  the  block  of  memory 
defined  by  the  first  two  addresses  to  the  location  in  memory 
starting  at  the  third  address.  The  original  block  is  unchanged 
unless  the  third  address  resides  within  this  block. 

2.  D  <hadr>?  <hval>*  —  deposit  the  specified  values  into 
memory . 

3.  E  (<hadr>  <hadr>?)?  —  examine  a  specific  memory 
location  or  block  of  memory. 

*t.  F  <hadr>  <hadr>  <hval>*  —  find  all  occurrances  of  the 
specified  byte  string  in  the  specified  memory  block. 

5.  S  <hadr>?  —  set/display  the  default  pointer. 

6.  X  —  return  to  ARIAN  Command  mode. 

These  commands  are  also  interpreted  like  MCS  commands.  If  more  than  one 
value  is  specified  in  the  command,  successive  values  are  separated  by  one  or 
more  spaces.  <hadr>  is  a  16-bit  quantity,  and  <hval>  is  an  8-bit  quantity; 
<hadr>  is  an  address,  and  <hval>  is  a  value.  Refer  to  Appendix  I  for  more 
detailed  information  on  the  Utility  subsystem.  The  Utility  subsystem  commands 
are  derived  from  MCS  VI. 6;  the  most  complete  description  of  these  commands  is 
available  in  the  "Monitor  Command  System  User's  Manual". 
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CHAPTER  7 

SUMMARY  of  the  ARIAN  II  COMMANDS 


ARIAN  II  supports  over  30  Executive,  or  Level  2,  commands.  Several  of 

these  commands  have  been  mentioned  so  far,  and  Appendix  I  covers  all  of  these 
commands  in  detail. 

The  Executive  commands  are  grouped  into  nine  catagories.  They  are: 

1 .  System  Control 

2.  Primary  File  Editing 

3.  Local  File  Control 

4.  Disk  File  Control 

5.  Local/Disk  File  Transfer 

6.  List/Print 

7.  Program  Debugging 

8.  Assembler 

9.  Utility 


1  System  Control 

The  System  Control  commands  are  CMND,  CONT,  CUST,  EXEC,  EXIT,  RESET,  SETC, 
TABS,  and  TERM. 

The  CMND  command  toggles  the  Level  3  command  mode.  It  is  used  to  engage 
and  disengage  Command  Level  3  as  well  as  specify  the  Command  Drive  number. 

The  CONT  and  EXEC  commands  are  used  to  explicitly  execute  a  program  or 
continue  the  execution  of  a  program.  EXEC  has  a  large  number  of  options, 
including  assembling  and  executing  the  primary  file,  loading  and  executing  a 
disk  file,  and  executing  a  program  stored  in  memory.  CONT  is  used  only  to 
execute  a  program  stored  in  memory;  it  is  generally  used  to  continue  from  a 
breakpoint.  This  command  loads  the  registers  from  the  register  save  area  and 
then  branches  to  the  program  in  memory. 

CUST  and  TERM  are  the  customized  command  and  the  Terminal  subsystem 
described  earlier. 

EXIT  returns  to  FDOS. 

RESET  is  the  same  as  a  warm  start.  Refer  to  Appendix  I  for  a  detailed 
description  of  the  effects  of  a  warm  start. 

SETC  is  used  to  redirect  either  input,  output,  or  both  to  a  program  located 
in  memory. 

Finally,  TABS  is  used  to  set  and  reset  the  tab  stops  used  by  the  input  line 
editor. 
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2  Primary  File  Editing 

The  Primary  File  Editing  commands  are  <lnum>,  APND,  DEL,  EDIT,  FIND,  ISRT, 
and  RNUM.  These  were  discussed  earlier. 


3  Local  File  Control 

The  Local  File  Control  commands  are  FCHK,  FILE,  LDEL,  LDIR,  LNAME,  LSCR, 
and  RCVR.  There  were  also  discussed  earlier. 


4  Disk  File  Control 

The  Disk  File  Control  commands  are  DDEL,  DDIR,  and  D11AKE.  They  were 
discussed  earlier. 


5  Local/Disk  File  Transfer 

The  Local/Disk  File  Transfer  commands  are  LOAD  and  SAVE.  They  were 
discussed  earlier. 


6  List/Print 

The  LIST  command  is  used  to  list  all  or  selected  portions  c T  the  primary 
file  on  the  principal  I/O  device;  PRINT  prints  all  or  selected  portions  of  the 
primary  file  on  the  printer.  If  the  file  is  in  ARIAN  II  assembler  format,  LISTF 
and  PRINF  will  list  and  print  in  columnar  format. 


7  Program  Debugging 

The  Program  Debugging  command  is  BREK.  It  is  used  to  set,  reset,  and 
examine  bre?xoints  in  memory.  A  breakpoint  takes  the  form  of  a  one-byte 
subroutine  call  which  returns  control  to  ARIAN  II,  preserving  the  current  values 
of  the  registers  and  the  Program  Counter. 

When  a  breakpoint  is  set,  the  byte  of  the  program  addressed  by  the  user  is 
saved  in  the  breakpoint  save  area  and  it  is  replaced  by  a  RST  1  instruction. 
When  breakpoints  are  reset  the  replaced  byte  is  copied  back  to  its  previous 
location . 

Upon  encountering  a  breakpoint,  the  breakpoint  is  automatically  reset.  The 
user  may  then  examine  the  contents  of  the  registers,  which  is  stored  in  the 
register  save  area,  and  continue  program  execution  by  using  the  CONT  command. 
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8  Assembler 

The  assembler  commands  are  ASSM  and  STMT. 

SYMT  displays  the  symbol  table  from  the  last  assembly  on  the  principal  I/O 
device.  The  user  should  employ  this  command  immediately  after  the  assembly;  the 
symbol  table  is  destroyed  by  disk  accesses  and  the  execution  of  Level  3 
commands. 

ASSM  is  used  to  assemble  the  primary  file.  ASSM  produces  no  listing,  ASSML 
produces  a  normal  listing,  ASSMP  prints  the  listing  on  the  printer,  ASSMF  lists 
the  output  in  formatted  mode  on  the  principal  I/O  device,  and  ASSMX  prints  the 
file  in  formatted  mode  on  the  printer  without  generating  code. 


9  Utility 

The  UTIL  command  invokes  the  Utility  subsystem;  th*.s  was  discussed  earlier. 
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Introduction 


ARIAN  II  has  an  extensive  set  of  Executive,  or  Level  2,  commands  which  give 
the  user  a  great  deal  of  control  over  the  microcomputer  system  and  the  creation 
of  his  programs.  This  control  includes  the  abilities  to: 

1.  Examine  and  modify  memory  directly, 

2.  Control  the  system  environment, 

3.  Control,  modify,  and  execute  all  programs  available 
to  the  user, 

4.  Debug  user  programs  through  specialized  system 

commands,  and  , 

5.  Assemble  programs  in  ARIAN  II  Z80  assembly 
language. 

The  purpose  of  this  appendix  is  to  catagorize  the  Executive  commands  of 
ARIAN  II  and  explain  them  in  detail.  The  two  contents  pages  at  the  beginning  of 
this  appendix  are  designed  to  be  used  for  quick  reference;  they  index  the 
commannds  alphabetically  and  by  function.  The  descriptions  of  the  commands 
start  on  page  6;  the  commands  are  ordered  alphabetically  throughout  this 
appendix. 

The  entries  for  each  command  consist  of  the  following  parts: 

1.  The  name  of  the  command, 

2.  A  brief  description  of  the  function  of  the  command, 

3.  A  pseudo-SDL  representation  of  the  formats  the 
commands  can  assume, 

4.  A  more  detailed  description  of  the  function  of  the 
command,  and 

5.  Examples  of  the  use  of  the  command. 

The  following  is  a  String  Description  Language  (SDL)  representation  and 
explanation  of  the  "obvious"  tokens  used  in  the  format  representations. 

<blank>  :  '  ' 

<digit>  :  'O'  !  ...  !  '9' 

<hexdigit>  :  <digit>  !  'A'  !  ...  !  »F’ 

<alpha>  :  'A'  !  ...  !  ’Z'  !  'a'  !  ...  I  ’z’ 

<alphit>  :  <alpha>  !  <digit> 

<quote>  : 

<text>  :  "any  sequence  of  ASCII  characters  whose  hexadecimal 
values  range  from  20H  to  7EH" 

<string1>  :  <quote>  <text> 

<string>  :  <string1>  <quote> 

<cmndname>  :  <alpha>  <alphit>*3 
<fname>  :  <alpha>  <alphit>*7 
<lnum>  :  <digit>  <digit>*3 
<inc>  :  <lnum> 

<hadr>  :  <digit>  <hexdigit>*3  !  'O'  <hexdigit>»4 
<delim>  :  <blank>  ! 

COMMAND_NAME  :  <cmndname> 

FILEJJAME  :  <fname> 

LINE  NUMBER  :  <lnum> 
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HEXVAL  :  <hadr> 

ARIAN_COMMAND  :  <cmndname>  <alphit>*  <blank>+ 

<fname>?  <delim>+ 

(<string1>  !  <string>  <delim>*  <string1>  ! 

<string>  <delim>*  <string>) 

(<delim>+  (<lnura>  !  <hadr>)  <delim>*)  *3 

As  can  be  seen  by  the  above  description,  a  command  in  ARIAN  II 
(ARIAN_COMMAND)  can  take  a  large  number  of  forms.  It  can  be  thought  of  as  being 
divided  into  up  to  seven  free-format  fields.  These  fields  are,  in  order: 

1 .  The  name  of  the  ARIAN  II  command  and  its  affixed 
options, 

2.  The  name  of  an  ARIAN  II  file  or  command  [optional], 

3.  Up  to  two  strings,  enclosed  in  quote  marks  (") 

[optional] , 

4.  Up  to  three  line  numbers  and/or  hexadecimal  values 
[optional]. 

Hence,  the  following  are  examples  of  valid  ARIAN  II  command  forms: 
FILE  PROGRAM 
LIST  100,2000 
LIST  100  2000 
TEST  3000  0F0F0  40 
TEST2  3000, 0F0F0, 140 
CUSTD  TEST 

SAVEB1  BINARY1  3*400  3*4FF  06800 
FINDF  "THIS  IS  A  TEST" 

SUBS  "THIS  IS  IT" "THIS  IS  A  TEST" 

SUBS  "THIS  IS  A  TEST",  "THIS  IS  A  TEST" 

ALLOFIT  <fname>  "STRING 1"  "STRING2"  10,20  30 
allofit  filename  "STRING1",  "STRING2"  10,20  30 


The  entries  in  several  fields  of  an  ARIAN  II  command  are  automatically 
capitalized  internally  by  the  command  and  argument  parser  of  ARIAN  II. 
Specifically,  these  fields  are  the  command  name  and  the  appended  characters 
(<cmndname>  <alphit>*),  the  file  name  (<fname>),  and  the  alphabetic  hexadecimal 
digits  in  the  hexadecimal  value  fields  (<hadr>).  Hence,  the  user  can  type  his 
commands  in  upper  or  lower  case  characters  and  they  will  be  interpreted  in 
exactly  the  same  way.  Also  by  this  token,  all  command  names,  options  fields, 
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and  file  names  are  forced  to  consist  of  capitalized  characters  by  the  system. 
For  example,  the  following  forms  of  commands  are  equivalent: 

Form  1  Form  2 


allofit  filename  "stringl"  ALLOFIT  FILENAME  "stringl" 
savebl  binaryl  3*100  3*1ff  6800  SAVEB1  BINARY1  3*100  34FF  6800 
list  100,200  LIST  100  200 


In  the  case  of  the  command  "ALLO",  the  referenced  file  is  named  "FILENAME" 
and  the  string  is  "stringl".  Note  that  the  capitalization  rule  does  not  affect 
strings. 

In  the  case  of  the  command  "SAVE",  the  referenced  file  is  named  "BINARY1" 
and  the  addresses  are  3*100,  3*1FF,  and  6800. 

In  the  case  of  the  command  "LIST",  the  lines  are  100  and  200. 
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Command:  <lnum> 

Brief  Description:  Any  line  starting  with  a  line  number  inserts  that  line 
into  the  primary  file  at  the  correct  position. 

Format:  <lnum>  <text> 


The  user  may  insert  a  line  of  text  into  the  primary  file  or  replace  a  line 
already  in  the  primary  file  by  simply  typing  the  desired  line  number  followed  by 
a  <SP>  and  the  text  of  the  line.  This  feature  of  ARIAN  provides  for  very  simple 
line  insertion  and  replacement. 


Example:  325  THIS  IS  LINE  325 


Result :  The  above  line  (325)  is  entered  into  the  primary  file.  If  line 
325  already  exists,  it  will  be  replaced  by  the  above  line;  if  it  does  not  exist, 
line  325  will  be  inserted  between  lines  324  and  326  (or  the  nearest  lines  to 
this  range)  in  the  primary  file. 
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Command:  APND 

Brief  Description:  APND  places  the  following  block  of  lines  after  the 
specified  or  implied  line  in  the  file.  The  block  of  lines  is  then  typed  by  the 
user  in  block  line  entry  mode. 

Format :  APND  <lnum>? 

Format :  APNDN  <lnum>? 


The  APND  (append)  command  is  one  of  two  block  line  entry  commands  of  the 
ARIAN  editing  subsystem.  Block  line  entry  in  ARIAN  permits  the  user  to  type  an 
arbitrary  number  of  lines  into  the  primary  file  without  typing  their 
corresponding  line  numbers.  When  the  user  has  finished  typing  this  group  of 
lines,  he  then  types  a  Ctrl-C  followed  by  a  <CR>.  These  lines  will  then  be 
entered  into  the  primary  file  at  the  appropriate  place.  If  the  Ctrl-C  is  at  the 
end  of  a  line,  it  will  not  be  included  in  this  line,  and  this  line  will  be  the 
last  line  of  the  block;  if  Ctrl-C  is  the  first  character  of  a  line,  the  previous 
line  will  be  the  last  line  of  the  block. 

APND  without  a  line  number  will  enter  the  block  of  lines  after  the  last 
line  of  the  file.  APND  with  a  line  number  will  enter  the  block  of  lines  after 
the  specified  line  and  before  the  next  line  in  the  file. 

APND  will  renumber  the  file  once  the  block  line  entry  mode  is  exited,  and 
APNDN  will  not. 


Example:  APND 


Result:  The  user  is  prompted  with  a  "?",  after  which  he  types  a  line  of 
text.  If  this  line  is  not  terminated  by  a  Ctrl-C  and  <CR>,  another  prompt 
appears  and  he  may  then  type  another  line  of  text.  This  process  continues  until 
he  either  ends  a  line  with  a  Ctrl-C  <CR>  or  begins  a  line  with  a  Ctrl-C  <CR>. 
At  this  time,  the  block  of  lines  he  has  just  typed  will  be  appended  to  the 
primary  file  and  the  primary  file  will  be  renumbered. 


Example:  APND  100 


Result:  The  same  procedure  is  executed  as  described  above,  but 
of  lines  is  inserted  between  line  100  and  the  next  line  in  the  file. 
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Command:  ASSM 

Brief  Description:  ASSM  causes  ARIAN  to  assemble  the  primary  file. 
Format:  ASSM  <fname>?  (<hadr>  <hadr>?)? 

Format:  ASSMF  <fname>?  (<hadr>  <hadr>?)? 

Format:  ASSML  <fname>?  (<hadr>  <hadr>?)? 

Format:  ASSMP  <fname>?  (<hadr>  <hadr>?)? 

Format:  ASSMX  <fname>?  (<hadr>  <hadr>?)? 


The  ASSM  command  instructs  ARIAN  to  assemble  the  primary  file.  If  <fname> 
is  specified,  an  entry  is  made  in  the  binary  file  directory  which  specifies  the 
boundaries  of  the  object  code  generated  by  the  assembler.  If  no  address  is 
given,  the  object  code  generated  by  the  assembler  is  placed  immediately  after 
the  local  text  file  workspace;  if  one  address  is  given,  the  object  code  is 
placed  starting  at  this  address;  if  two  addresses  are  given,  the  object  code  is 
assembled  to  execute  at  the  first  address  and  it  is  physically  placed  in  memory 
starting  at  the  second. 

ASSM  assembles  the  primary  file  and  lists  only  the  lines  with  errors  in 
them.  ASSML  lists  the  file  in  paged  mode  on  the  user’s  CRT  as  it  is  being 
assembled,  ASSMF  lists  the  file  in  formatted  paged  mode  on  the  user’s  CRT  as  it 
is  being  assembled,  ASSMP  prints  the  file  on  the  user's  printer  as  it  is  being 
assembled,  and  ASSMX  lists  the  file  in  formatted  paged  mrde  on  the  user's 
printer  as  it  is  being  assembled  and  does  not  place  ar.j  axle  into  memory. 


Example:  ASSM  T1  5800  6800 


Result:  The  primary  file  will  be  assembled  to  execute  at  location  5800, 
and  the  object  code  will  be  placed  at  location  6800.  The  local  binary  file  T1 , 
which  defines  the  limits  of  the  assembly  in  terms  of  the  5800  address  will  be 
produced. 


Example:  ASSML 


Result:  The  primary  file  is  assembled  at  the  end  of  the  workspace.  All 
lines  with  their  object  code  are  listed  on  the  user's  CRT.  For  example,  if  the 
workspace  is  defined  to  be  2000  to  5000  hexadecimal,  the  object  code  will  be 
placed  starting  at  5001. 
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Command:  BREK 

Brief  Description:  BREK  is  used  to  set ,  reset , 
Format :  BREK  <hadr> 

Format :  BREKD  <hadr> 

Format :  BREKL 
Format:  BREKS 


and  display  breakpoints. 


The  breakpoint  (BREK)  commands  permit  the  user  to  set,  reset,  and  display 
the  breakpoints.  When  a  breakpoint  is  reached  during  a  program's  execution,  the 
byte  replaced  by  the  breakpoint  is  restored,  the  contents  of  the  registers  is 
displayed  to  the  user,  the  contents  of  all  the  registers  are  saved  in  the 
register  save  area  of  ARIAN,  and  control  is  returned  to  ARIAN.  If  the  user 
wishes  to  resume  program  execution,  he  may  do  so  by  using  the  CONTinue  command. 

BREK  will  set  a  breakpoint  at  the  specified  address;  BREKD  will  clear  the 
breakpoint  at  the  address  specified  if  there  is  one  and  inform  the  user  if  there 
is  no  breakpoint  at  this  address;  BREKL  will  list  the  addresses  of  all 
breakpoints  set  by  the  user  that  have  not  yet  been  cleared;  and  BREKS  will 
scratch  (clear)  all  user  breakpoints  that  have  not  yet  been  cleared. 

Note:  a  breakpoint  is  cleared  when  it  is  encountered  during  a  program's 
execution. 


Example:  BREK  4000 


Result:  A  one-byte  breakpoint  is  set  at  location  4000  hexadecimal.  If  the 
user’s  program  later  encounters  this  breakpoint,  control  will  be  restored  to  the 
user  through  ARIAN. 


Example:  BREKL 


Result:  The  addresses  of  all  remaining  breakpoints  will  be  listed. 
Example :  BREKS 

Result:  All  remaining  breakpoints  will  be  scratched. 
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Command:  CMND 

Brief  Description :  CMND  is  used  to  toggle  the  level  3  command  facility  and 
set  the  number  of  the  CL3  drive. 

Format:  CMND  <cdrive>? 


If  <cdrive>  is  specified,  the  indicated  drive  number  (1-4)  will  be  made  the 
CL3  drive.  If  it  is  not  specified,  CL3  will  simply  be  toggled;  if  CL3  is  on,  it 
will  be  turned  off,  and  if  CL3  is  off,  it  will  be  turned  on  with  drive  1  being 
designated  the  CL3  drive. 

The  CL3  drive  is  the  drive  whose  disk  is  searched  for  a  level  3  command  if 
the  search  for  the  current  user  command  fails  at  levels  1  and  2. 

The  first  digit  of  the  ARIAIJ  II  prompt  indicates  the  status  of  CL3.  If 
this  digit  is  0,  CL3  is  off;  otherwise,  CL3  is  on  and  this  digit  indicates  the 
number  of  the  CL  3  drive. 


Example:  01>CMND 


Result:  11> 

CL3  was  disengaged  when  CMND  was  typed,  and  drive  1  was  designated  to  be 
the  CL3  drive  as  a  result. 


Example:  11>CMND  4 


Result:  41> 

Drive  4  was  designated  the  CL3  drive. 


Example:  41>CMND 


Result:  01 > 

0L3  was  disengaged. 


Example:  01>CMND  2 


Result:  21> 

Drive  2  was  designated  as  the  CL3  drive. 
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Command:  CONT 

Brief  Description:  CONT  allows  the  user  to  continue  from  a  breakpoint  or 
begin  execution  of  a  program  with  specific  register  values. 

Format :  CONT  <hadr>? 


The  CONTinue  command  is  one  of  two  commands  which  allow  the  user  to 
explicitly  execute  a  program  in  the  microcomputer's  memory  (EXEC  is  the  other). 
CONT  may  be  used  to  either  continue  a  program's  execution  after  a  breakpoint  has 
been  encountered  or  explicitly  execute  a  program  at  a  specified  address. 

When  a  breakpoint  is  encountered,  the  contents  of  all  the  registers  of  the 
microprocessor  are  saved  in  the  register  save  area  in  the  ARIAN  scratchpad  RAM, 
thereby  permitting  the  user  to  examine  and  modify  these  values  at  his  leasure 
through  the  REGS  level  3  command.  CONT  with  no  argument  will  permit  the  user  to 
continue  execution  of  the  program  under  test  with  the  registers  of  the 
microprocessor  loaded  with  the  values  stored  in  the  register  save  area. 

CONT  with  a  specified  address  as  an  argument  also  loads  the  registers  of 
the  microprocessor,  but  execution  is  begun  at  the  address  specified.  Hence, 
dynamic  debugging  of  user  subroutines  is  possible  by  using  this  command. 


Example:  CONT  4000 


Result:  The  values  stored  in  the  register  save  area  are  loaded  into  the 
appropriate  registers  and  the  program  starting  at  location  4000  hexadecimal  is 
executed . 
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Brief  Description:  CUSTomize  allows  the  user  to  create,  delete,  or  rename 
a  customized  command.  Provision  is  also  made  to  list  and  scratch  all  customized 
commands. 

Format:  CUST  <cname>  <hadr>? 

Format :  CUSTD  <cname> 

Format:  CUSTL 
Format:  CUSTN  <cname> 

Format :  CUSTS 


CUSTomize  is  perhaps  one  of  the  most  powerful  commands  in  ARIAN' s 
repertoire.  This  command  allows  the  user  to  add  his  own  set  of  commands  to 
those  already  executed  by  ARIAN.  The  user  may  give  his  additional  commands  any 
names  he  wishes,  including  the  names  of  the  commands  already  defined  by  ARIAN. 
If  the  user  wishes  to  redefine  an  ARIAN  command  in  this  manner,  his  customized 
subroutine  replaces  the  system  subroutine  normally  used  to  execute  that  command. 
This  replacement  is  in  effect  until  the  user  resets  ARIAN  or  deletes  his 
customized  command.  Other  options  under  the  CUST  core  include  CUSTD  to  delete  a 
specified  customized  command,  CUSTL  to  list  all  the  customized  commands  and 
their  execution  addresses,  CUSTN  to  rename  a  customized  command,  and  CUSTS  to 
scratch  (delete)  all  the  customized  commands. 

The  CUST  command  by  itself  is  used  to  create  or  redefine  a  customized 
commmand.  CUST  with  no  address  creates  a  customized  command  which  will  begin 
execution  at  the  default  address;  CUST  with  an  address  defines  the  command 
explicitly  to  execute  at  the  specified  address.  If  a  customized  command  of  the 
same  name  already  exists,  the  user  is  prompted  with  the  "REPLACE?"  message,  to 
which  he  responds  with  a  "Y"  if  he  wishes  to  redefine  the  execution  address  of 
that  customized  command  or  "N"  if  he  does  not. 

The  functions  of  CUSTS,  CUSTL,  and  CUSTD  are  executed  without  any 
particular  response  to  the  user.  CUSTN  prompts  the  user  with  "NAME?",  to  which 
he  may  respond  with  the  new  name  of  the  file  or  just  a  <CR>  to  abort.  The  new 
name  is  terminated  with  a  <CR>. 


Example:  CUST  TEST 


Result:  The  customized  command  "TEST"  is  created.  It  executes  at  the 
current  value  of  the  default  assembly  address. 
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Result:  TEST  B800 

The  names  of  all  the  customized  commands  and  their  execution  addresses  are 
displayed. 
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Command :  DDEL 

Brief  Description:  DDEL  allows  the  user  to  delete  the  specified  disk  file. 
Format :  DDEL  <fname> 

Format:  DDELn  <fname> 


DDEL  deletes  the  specified  disk  file  from  the  disk  file  directory.  Only 
the  directory  entry  is  deleted,  but  the  space  occupied  by  the  file  is  released 
and  subject  to  user  compaction  and  the  disk  management  routines. 

As  with  all  disk-related  commands,  the  disk  drive  number  may  be  specified 
as  a  fifth  character  of  the  command. 


Example:  DDEL  TEXT1 


Result:  The  entry  for  the  disk  file  TEXT1  is  deleted  from  the  disk 
directory. 


Example:  DDEL 3  TEXT1 

Result:  The  entry  for  the  disk  file  TEXT1  residing  on  disk  drive  3  is 
deleted  from  that  disk  directory.  Drive  3  becomes  the  logged-in  drive. 
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Command;  DDIR 

Brief  Description;  DDIR  displays  an  organized  listing  of  the  directory  of 
the  disk  on  the  specified  drive. 

Format ;  DDIR 

Format:  DDIRn 


The  disk  directory  command  (DDIR)  displays  the  contents  of  the  directory  of 
the  disk  currently  mounted  on  the  specified  drive.  Each  directory  entry 
contains  the  name  of  the  file,  the  length  of  the  file  as  a  decimal  number  of 
256-byte  blocks,  the  type  of  the  file,  and  the  execution  or  load  address  of  the 
file  if  it  is  a  binary  file.  The  types  of  files  permitted  by  ARIAN  are  general 
text  files  (type  0),  binary  files  (type  1),  BASIC  program  files  (type  2),  and 
BASIC  data  files  (type  3). 

The  disk  drive  number  of  the  desired  drive  may  be  specified  as  the  fifth 
character  of  the  command.  If  this  is  done,  that  drive  automatically  becomes  the 
logge^-in  drive. 


Example:  DDIR2 


Result:  The  disk  directory  of  the  disk  on  drive  2  is  displayed  to  the 
user.  Drive  2  becomes  the  logged-in  drive. 
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Command:  DEL 

Brief  Description :  DEL  allows  the  user  to  delete  either  a  specified  line 
or  block  of  lines  from  the  primary  file. 

Format:  DEL  <lnum>  <lnum>? 


The  function  of  the  DELete  command  is  to  delete  lines  from  the  primary 
file.  DEL  followed  by  a  line  number  will  delete  only  that  line;  DEL  followed  by 
two  line  numbers  will  delete  the  block  of  lines  enclosed  by  the  specified  lines, 
inclusive.  If  a  specified  line  number  does  not  exist  in  the  file,  the  line 
number  of  the  line  which  would  follow  the  specified  line  if  it  existed  will  be 
used;  if  the  specified  line  number  is  larger  than  the  largest  line  number  in  the 
file,  the  last  line  will  be  deleted. 


Example :  DEL  100 


Result :  Line  100  is  deleted  from  the  primary  file. 


Example:  DEL  100  150 


Result:  Lines  100  to  150,  inclusive,  are  deleted  from  the  primary  file. 
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Command:  DNAME 

Brief  Description:  DNAMe  allows  the  user  to  rename  a  specified  disk  file. 
Format :  DNAM  <fname> 

Format:  DNAMn  <fname> 


The  disk  file  rename  (DNAM)  command  renames  the  specified  disk  file.  In 
response  to  this  command,  ARIAN  will  prompt  the  user  with  "NEW  NAME?",  to  which 
the  user  may  type  the  new  name  for  the  file  or  just  a  <CR>  to  abort  the  renaming 
function. 

Like  the  other  disk-related  commands,  the  fifth  character  of  DNAM  may  be  a 
digit  from  1  to  M ,  specifying  the  number  of  the  disk  drive  the  file  resides  on. 
This  drive  will  be  the  new  logged-in  drive  as  the  result. 


Example:  DNAME  OLDFILE 


Result:  ARIAN  will  respond  with  "NEW  NAME?",  to  which  the  user  may  respond 
with  the  new  name  of  the  file  OLDFILE.  A  <CR>  will  abort  the  process. 
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Command:  EDIT 

Brief  Description:  EDIT  allows  the  user  to  edit  a  specified  line  of  the 
primary  file.  It  is  an  intra-line  editor. 

Format:  EDIT  <lnum> 


The  EDIT  command  invokes  the  ARIAN  intra-line  editor.  The  editor  allows 
the  user  to  edit  a  line  that  has  already  been  typed  without  retyping  the  entire 
line.  The  specified  line,  or  the  line  that  would  follow  the  specified  line  if 
this  line  does  not  exist,  will  be  edited. 

The  intra-line  editor  is  a  dynamic  editor  which  permits  the  user  to  see  the 
effects  of  his  editing  commands  immediately  after  he  types  them.  When  a  line  is 
edited,  it  is  copied  into  the  editor's  old  line  buffer  and  then  displayed  to  the 
user.  The  editor  then  does  a  <CR>  and  prompts  the  user  with  a  "?".  As  the  user 
edits  this  line,  each  character  of  the  new  line  that  is  created  is  placed  into 
the  editor's  new  line  buffer;  the  original  line  in  the  old  line  buffer  is  not 
affected.  Finally,  when  editing  is  finished,  the  user  may  type  a  <CR>  to 
terminate  the  editing  process  and  replace  the  original  line  in  the  file  with  the 
line  as  it  exists  in  the  new  line  buffer. 

The  intra-line  editor  responds  to  a  number  of  subcommands.  The  following 
is  a  complete  list  of  these  commands  and  their  functions. 

1 .  <BS>  --  back  up  the  new  line  pointer  and  delete  the 
previous  character.  This  command,  echoed  as  a  backspace,  is 
used  to  delete  the  previous  character  in  the  line.  Only  the 
new  line  pointer  is  affected  by  it. 

2.  <CR>  —  terminate  creation  of  the  new  line.  This 
command  terminates  editing  of  the  line  and  replaces  the 
original  line  in  the  primary  file  with  the  line  that 
currently  exists  in  the  new  line  buffer.  If  <CR>  is  the 
first  editing  character  typed,  the  edit  is  aborted  and  no 
replacement  occurs. 

3.  <DEL>  —  the  delete  key  backs  up  the  new  line 
pointer.  The  characters  backed  over  are  enclosed  in  "<"  and 
">"  and  deleted  from  the  new  line.  Only  the  new  line 
pointer  is  affected  by  this  command. 

*4.  <SP>  —  the  space  bar  functions  to  copy  the 
character  pointed  to  by  the  old  line  pointer  into  the 
character  position  pointed  to  by  the  new  line  pointer  and 
advance  the  old  line  and  new  line  pointers  by  one.  The 
space  bar,  therefore,  will  simply  copy  the  next  character 
from  the  old  line  buffer  into  the  new  line  buffer.  After 
the-  copy  is  done,  the  copied  character  will  be  displayed  to 
the  user. 

5.  A  —  abort  the  editing  of  the  old  line.  This 
command  may  be  typed  whenever  the  editor  is  ready  to  receive 
a  command  (i.e.,  the  editor  is  not  in  the  middle  of  an 
insertion  or  replacement).  It  terminates  the  edit  and 
returns  control  to  ARIAN  without  affecting  the  original 
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line. 

6.  D  —  delete  the  character  pointed  to  by  the  old 
line  pointer  (delete  the  next  character  in  the  old  line). 
The  character  is  deleted  by  advancing  the  old  line  pointer 
by  one  character  position  and  not  affecting  the  new  line 
pointer.  The  deletion  is  displayed  to  the  user  as  a 
backslash  ("\")  followed  by  the  deleted  character.  If  the 
next  command  typed  by  the  user  is  another  D,  the  next 
deleted  character  is  displayed  (without  the  backslash). 
This  will  continue  until  the  user  types  some  other  command, 
in  which  case  a  closing  backslash  will  be  printed  and  that 
command  will  be  executed.  In  effect,  the  deleted  characters 
will  be  enclosed  in  backslashes  when  displayed  to  the  user. 

7.  E  —  skip  to  the  end  of  the  line.  The  rest  of  the 
characters  in  the  old  line  buffer  are  copied  into  the  new 
line  buffer  and  both  pointers  are  advanced  to  point  to  the 
non-existent  character  after  the  last  character  copied.  The 
copied  characters  are  displayed  to  the  user  as  they  are 
copied. 

8.  I  —  insert  a  string  of  characters  in  front  of  the 
character  currently  pointed  to  by  the  old  line  pointer.  In 
response  to  the  I  typed  by  the  user,  the  editor  types  a 
slash  ("/").  The  user  may  they  type  any  string  of 
characters  he  wishes  except  for  an  escape  or  carriage 
return.  These  characters  will  be  copied  into  the  new  line 
buffer,  the  new  line  pointer  will  be  advanced,  and  each 
character  will  be  echoed  to  the  user  as  he  types  it. 

The  escape  and  carriage  return  characters  are  special 
characters  to  the  ilsert  subcommand j  <ESC>  instructs  the 
insert  subcommand  to  end  the  insertion.  The  editor  then 
types  another  slash  to  indicate  that  the  insertion  is 
finished  and  allows  the  user  to  continue  editing  normally. 
<CR>  instructs  the  editor  to  terminate  creation  of  the  new 
line,  copy  the  new  line  into  the  primary  file,  and  return  to 
ARIAN  command  mode.  The  <CR>  is  echoed  as  a  slash,  a 
carriage  return,  and  a  system  prompt,  indicating  that  ARIAN 
is  now  in  command  mode. 

The  backspace  character  performs  its  normal  function 
while  in  this  mode. 

9.  P  —  print  the  new  line  and  edit  it.  The  command 
will  terminate  the  new  line  at  the  current  position  of  the 
new  line  pointer,  copy  the  new  line  buffer  into  the  old  line 
buffer,  print  the  new  line,  and  restart  the  editing  process 
with  this  new  line  instead  of  the  original  line.  The 
original  line  as  it  exists  in  the  primary  file  is  not 
affected . 

10.  R  —  replace  the  characters  pointed  to  by  the  old 
line  pointer  with  the  following  string.  Both  pointers  are 
advanced  and  the  new  characters  are  echoed  to  the  user.  No 
special  character  is  typed  to  the  user  after  he  types  an  R, 
and  the  <ESC>,  <CR>,  and  <BS>  characters  respond  as  in  the  I 
command  except  that  no  slash  is  printed.  In  effect,  as  the 
user  types  his  string,  each  character  he  types  replaces  the 
corresponding  character  in  the  old  line  buffer. 
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11.  S  <letter>  —  skip  to  the  specified  letter.  This 

is  the  only  two-character  command  in  the  editor;  it  consists 
of  the  letter’  S  followed  by  a  single  character.  When  this 
command  is  typed,  both  the  old  and  new  line  pointers  are 
advanced  and  the  corresponding  characters  are  typed  and 
copied  into  the  new  line  buffer  until  the  specified 

character  is  found  or  the  end  of  the  line  is  reached.  Once 
the  specified  character  is  found,  the  old  line  pointer  will 
point  to  it  and  this  character  will  not  be  printed;  it  will 
be  the  next  character  in  the  line.  The  S  and  the  specified 
letter  are  not  echoed  to  the  user  when  the  command  is  typed. 
This  command  is  very  useful,  particularly  when  the  user 
wishes  to  insert,  delete,  or  replace  at  a  specified 

character;  he  does  not  have  to  space  over  to  that  character 
with  this  command. 

12.  X  —  exit  and  reedit  the  old  line.  The  X  command 

terminates  the  editing  done  so  far  and  restarts  the  edit  of 
the  original  line.  If  a  P  command  has  been  previously 

typed,  the  last  line  placed  into  the  old  line  buffer  is 
reedited. 


The  editor  has  four  error  messages  that  it  may  display.  These  messages 

are: 

1.  ??  —  invalid  command.  A  double  question  mark 
indicates  that  an  invalid  command  has  been  typed.  No 
recovery  is  required  by  the  user;  he  may  continue  with  the 
desired  command. 

2.  **  —  end  of  edit  line.  A  double  asterisk 
indicates  that  the  user  has  tried  to  go  beyond  the  end  of 
the  original  line  illegally  while  editing. 

3.  *EOL*  —  end  of  line  buffer.  The  length  of  the  new 
line  has  just  reached  the  limits  of  the  new  line  buffer,  and 
the  user  must  reedit  the  original  line. 

4.  <BEL>  —  <BS>  error.  The  user  has  typed  a  <BS> 
which  attempted  to  delete  a  character  before  the  first 
character  in  the  line. 


Example:  EDIT  200 


Result:  Line  200  is  printed  and  the  user  is  prompted  with  a  The  user 
may  now  edit  line  200  using  the  intra-line  editing  commands.  One  useful  aspect 
of  this  command  is  that  line  200  may  be  copied  as  line  201  or  any  other  desired 
line  number  by  editing  only  the  line  number  and  typing  the  E  (skip  to  end  of 
line)  followed  by  a  <CR>.  Line  200  in  the  primary  file  will  be  unchanged  and 
line  20]  will  be  created  by  this  example. 
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Command:  EXEC 

Brief  Description:  EXECute  functions  to  allow  the  user  to  execute  or 
assemble  and  execute  a  specified  or  implied  file  or  program. 


Format : 

EXEC  (<fname>  !  <hadr»? 

Format: 

EXECn 

(<fname>  !  <hadr>)? 

Format: 

EXECB 

<fname>? 

Format : 

EXECF 

<fname>? 

Format: 

EXECL 

<fname>? 

Format : 

EXECP 

<fname>? 

The  EXECute  command  is  one  of  the  most  complex  of  the  ARIAN  commands.  EXEC 
allows  the  user  to  execute  a  text  file,  a  binary  file,  or  any  program  or 
subroutine  which  resides  in  memory  or  on  disk.  The  command  also  permits  a 
simple,  clean  return  to  ARIAN  by  pushing  a  return  address  onto  the  system  stack 
(which  may  also  be  used  as  the  program  stack);  by  keeping  the  stack  stable,  the 
user  may  return  to  ARIAN  when  his  program  is  finished  by  simply  executing  a 
return . 

The  EXEC  command  works  in  many  implicit  modes.  EXEC  with  no  arguments  will 
assemble  and  execute  the  primary  file.  This  means  of  program  execution  makes 
software  development  somewhat  easier  by  permitting  the  user  to  execute  his 
primary  file,  inter rrupt  the  program  if  it  malfunctions,  edit  the  file,  and 
reexecute  it  with  a  minimum  of  effort. 

EXEC  <fname>  will  perform  the  following  operations  in  the  order  specified: 

1.  It  will  first  search  the  local  file  directory  for 
the  specified  file.  If  this  file  is  found,  it  will  be  made 
primary,  assembled,  and  executed. 

2.  Secondly,  if  the  search  in  step  1  fails,  ARIAN  will 
search  the  disk  directory  of  the  logged-in  disk  drive  for 
the  specified  file.  If  the  file  is  found,  it  will  be  loaded 
into  memory. 

3.  If  step  2  fails,  an  appropriate  error  message  will 
be  given.  If  step  2  succeeds,  a  test  will  be  made  to  see  if 
the  file  is  binary  or  text.  If  it  is  binary,  it  will  be 
executed;  if  it  is  text,  it  will  be  assembled  and  executed. 

4.  In  all  cases  except  when  an  error  occurs,  a  binary 
file  of  the  specified  name  is  created. 

If  EXEC  <hadr>  is  used,  the  binary  program  starting  at  the  specified 
address  is  executed. 

Finally,  if  EXECB  is  used,  the  specified  binary  file  (as  defined  in  the 
binary  file  directory)  will  be  executed.  If  no  file  name  is  specified, 
execution  will  begin  at  the  default  execution  address. 

The  EXECF,  EXECL,  and  EXECP  variants  perform  functions  similar  to  those  of 
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ASSM.  EXECF  produces  a  formatted  listing  on  the  principal  I/O  device,  EXECL 
produces  a  simple  listing  on  the  principal  I/O  device,  EXECP  produces  a  simple 
printing  on  the  printer. 


Example:  EXEC  PROGRAM 


Result:  If  PROGRAM  is  a  local  text  file,  it  will  be  assembled  and 
executed.  If  PROGRAM  is  not  local  and  resides  on  disk,  it  will  be  loaded, 
assembled  if  it  is  a  text  file,  and  executed. 


Example:  EXEC  0F000 


Result:  The  machine  code  beginning  at  location  0F000  hexadecimal  is 
executed. 


Example:  EXECB  PROGRAMB 


Result:  The  binary  file  PROGRAMB  is  executed. 
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Command:  EXIT 
*  - 

* 

Brief  Description:  EXIT  allows  the  user  to  transfer  control  to  FDOS. 
Format:  EXIT 


EXIT  transfers  control  to  the  FDOS  disk  bootstrap  program.  FDOS  is  a 
modified  version  of  Northstar  Corporation's  DOS  program. 

The  system  status  of  ARIAN  is  not  affected  by  this  transfer  unless  the  user 
explicitly  or  implicitly  changes  ARIAN  or  its  system  RAM  area  after  the  control 
has  been  transferred. 

Reentry  may  be  made  to  ARIAN  in  two  ways  after  the  transfer  has  been 
accomplished:  (1)  by  branching  to  the  ARIAN  warm  start  address  (memory  location 
4)  or  (2)  by  branching  to  the  ARIAN  cold  start  address  (memory  location  0). 
Reentry  at  the  warm  start  address  preserves  the  state  of  ARIAN  at  the  time  of 
the  exit. 
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Command:  FCHK 

Brief  Description:  FCHK  functions  to  check  the  validity  of  a  local  text 
file.  This  command  checks  the  specified  or  implied  file  as  to  its  correctness 
in  format. 

Format:  FCHK  <fname>? 


The  file  check  (FCHK)  command  is  used  to  determine  the  validity  of  the 
specified  local  text  file.  This  verification  includes  checking  to  see  that  the 
character  count  for  each  line  is  correct,  each  line  terminates  with  a  <CR>,  the 
file  is  properly  terminated  by  an  <EOF>  mark  (binary  1),  and  the  local  text  file 
directory  limits  of  the  file  are  correct.  ARIAN  will  respond  with  "VALID  FILE" 
or  "INVLD  FILE"  when  the  test  is  finished. 

The  FILE,  RCVR,  and  LOAD  commands  do  an  implicit  file  check  whenever  they 
are  executed,  but  only  the  invalid  message  is  displayed  by  their  implicit 
cheeks. 

When  a  secondary  file  is  checked  for  validity  it  is  not  made  primary. 
There  is  no  overall  affect  on  the  ARIAN  system  as  a  result  of  executing  this 
command. 
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Command:  FILE 

Brief  Description:  The  FILE  command  allows  the  user  to  explicitly  create  a 
new  primary  local  text  file  or  a  binary  file  or  view  the  directory  information 
on  the  current  primary  local  text  file. 

Format:  FILE  (<fname>  <hadr>?)? 

Format:  FILEB  <fname>  (<hadr>  <hadr>)? 


The  FILE  command  is  one  of  the  most  powerful  and  complex  commands  in  ARIAN. 
This  command  is  used  to  create  the  primary  file  or  a  binary  file  and  display  the 
directory  entry  for  the  primary  file. 

The  FILE  command  with  no  arguments  displays  the  directory  entry  for  the 
primary  file.  This  entry,  like  the  entries  for  the  secondary  local  files, 
consists  of  the  name  of  the  file,  the  starting  and  ending  memory  addresses  of 
the  file,  and  the  number  of  the  last  line  in  the  file. 

The  FILE  <fname>  variant  creates  a  primary  file  of  the  name  specified.  If 
a  local  file  already  exists  with  this  name,  it  is  made  primary;  the  memory 
manager  is  invoked,  the  new  primary  file  is  moved  to  the  physical  end  of  the  old 
primary  file,  and  the  files  are  compacted  within  the  currently-defined  workspace 
boundaries.  If  no  local  file  with  this  name  exists,  the  new  primary  file  of 
length  zero  is  created  at  the  end  of  the  last  primary  file  and  compaction  is 
again  done.  Text  may  now  be  entered  into  the  primary  file  by  typing  line 
numbers  or  using  the  APND  command. 

If  an  address  is  specified  with  the  FILE  <fname>  variant,  the  new  primary 
file  is  placed  at  this  address.  Compaction  is  done  to  the  secondary  files,  but 
the  new  primary  file  is  unaffected  by  this  compaction.  Also,  the  workspace 
boundary  parameters  are  ignored  when  the  primary  file  is  placed,  permitting  the 
user  to  place  this  file  anywhere  he  wishes.  This  FILE  variant,  then, 
effectively  overrides  the  memory  manager;  however,  if  a  later  command  uses  the 
memory  manager,  the  primary  file  may  be  moved  and  compacted  by  the  memory 
manager  implicitly. 

FILEB  permits  the  user  to  explicitly  create  a  binary  file.  Binary  files 
are  defined  solely  by  their  entries  in  the  local  binary  file  directory;  they 
conform  to  no  particular  physical  structure  as  they  exist  in  memory.  FILEB  with 
no  numeric  argument  creates  a  binary  file  with  the  specified  name  at  the  default 
binary  file  limits  set  by  the  last  assembly;  FILEB  with  the  two  addresses 
creates  the  binary  file  with  these  addresses  as  its  boundaries. 


Example:  FILE  NEW 


Result:  If  file  NEW  already  exists  locally,  it  is  made  primary;  otherwise, 
a  new  text  file  is  created  with  the  name  "NEW"  at  a  location  determined  by  the 
workspace  manager.  File  compaction  and  workspace  compression  is  then  done  to 
all  local  files. 


J 
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ARIAH  II  EXECUTIVE  COMMANDO 


Example:  FILE 


Result :  The  local  directory  entry  for  the  current  primary  file  is 
displayed.  If  this  follows  the  above  example  and  NEW  did  not  previously  exist, 
then  an  entry  like 

NEW  3020  3020 

would  bo  displayed  to  the  user.  This  indicates  that  the  current  primary  file  is 
named  NEW,  it  is  a  null  file,  and  it  begins  and  ends  at  location  3020 
hexadecimal.  If  NEW  is  not  null,  an  entry  like 

NEW  3020  30^C  0050 

would  be  displayed  to  the  user.  In  this  case,  NEW  resides  at  locations  3020  to 
3'0’IC  hexadecimal,  inclusive. 


Example:  FILEE  El NARY  5000  5010 

Result:  The  local  binary  file  directory  entry  for  the  file  named  BINARY  is 
created.  This  command  defines  the  file  BINARY  to  reside  at  locations  5000  to 
5010  hexadecimal ,  inclusive. 
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ARIAN  II  EXECUTIVE  COMMANDS 


Command:  FIND 

Brief  Description:  FIND  searches  the  .primary  file  for  all  occur ranees  of 
the  specified  string. 


Format: 

FIND  ' 

v? 

""  <string> 

»  n  i  9 

Format: 

FIND  ' 

V  ? 

""  <string> 

<lnum> 

Format: 

FINDF 

>V’? 

""  <string> 

♦  »t  1  9 

Format: 

FINDF 

*  v  ? 

""  <string> 

""  <lnum> 

Format : 

FINDP 

'  v  ? 

""  <string> 

♦  ?T  1  9 

Format: 

FINDP 

'V  ? 

""  <string> 

""  <lnum> 

The  find  command  performs  a  search  through  the  primary  file  for  the 
specified  string.  If  no  line  number  is  specified,  the  search  is  done  over  the 
entire  file;  if  a  line  number  is  specified,  the  search  is  done  starting  at  the 
specified  line  and  extending  to  the  end  of  the  file. 

The  output  from  the  FIND  command  is  a  paged  listing  of  the  lines  which 
contain  the  specified  string.  If  the  listing  is  printed  on  the  printer,  thc- 
output  is  not  paged.  If  the  'V'  option  is  used,  the  FIND  command  will  pause- 
after  displaying  each  line.  The  user  may  then  type  <ECC>  to  abort  or  anything 
else  to  continue. 

The  FIND  command  by  itself  prints  the  lin^s  as  they  are  currently 
formatted;  FINDF  prints  the  lines  in  assembler  format;  and  FINDP  prints  the 
lines  as  they  are  currently  formatted  on  the  printer. 


Example:  FIND  "test"  HO 

Result :  All  lines  after  line  t’O,  inclusive,  containing  the  string  'test' 
will  be  printed. 


Example :  FINDF  "test 


Resul t :  All  lines  in  the  file  containing  the  string  'test'  (assuming  no 
blanks  exist  after  the  word  'test'  in  the  command)  will  be  printed  in  assembler 
format. 
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ARIAH  II  EXECUTIVE  COMMANDS 


Command:  ISHT 

Brief  Description:  Insert  the  following  block  of  lines  before  the 

specified  line  in  the  primary  file. 

Format :  ISRT  <lnum> 

Format:  ISHTN  <lnum> 


The  ISRT  command  is  the  same  as  the  APND  command,  except  that  the  ISRT 
command  places  the  block  of  lines  in  front  of  the  specified  line  while  API'S 
places  the  bloc!:  after  the  specified  line.  ISRT  must  have  a  line  number,  arid  it 
is  particularly  useful  in  inserting  lines  before  the  first  line  in  the  file. 
APND,  on  the  other  hand,  is  useful  for  appending  lines  to  the  end  of  the  file. 

ISRT  will  renumber  the  file,  and  ISRTIi  will  not. 


Example:  ISRT  300 


Result:  The  following  block  of  lines  entered  in  block  line  entry  mode  will 
be  placed  in  front  of  line  300. 
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ARIA'I  II  EXECUTIVE  COMMAND" 


Command:  LDEL 

Brief  Description:  LDEL  functions  to  delete  the  local  text  file  or  binary 
file  specified. 


Format :  LDEL  <fname> 
Format:  LDELD  <fnamo> 


The  local  file  delete  command  (LDEL)  is  used  to  delete  the  directory  entry 
of  the  specified  local  binary  or  text  file.  This  command  only  deletes  the 
directory  entry;  the  physical  fFle  is  unaffected  by  it.  LDEL  deletes  the 
specified  text  file,  while  LDELB  deletes  the  specified  binary  file. 


Pace  2F. 


ARIA?:  II  executive  commands 


Command:  LDIR 

Brief  Description :  LDIR  displays  the  specified  local  file  directory  to  the 

user. 


Format :  LDIR 
Format:  LDIRB 


The  local  directory  command  displays  the  local  text  and  binary  file 
directories.  LDIR  displays  the  local  text  file  directory,  anc!  LDIRB  displays 
the  local  binary  file  directory.  All  directory  entries  consist  of  the  names  of 
the  files  and  their  current  memory  address  boundaries.  LDIR  will  display  the 
entry  for  the  current  primary  file  first,  and  this  entry  is  followed  by  the 
entries  for  the  secondary  files. 

LDIRB  displays  the  local  binary  file  directory  and  the  limits  from  the  last 
assembly. 


Example :  LDIR 


Result:  A  list  of  al  the  current  local  text  files  is  displayed:  to  the 
user.  The  first  file  is  the  primary  file. 


Example :  LDIR3 

Result :  The  local  binary  file  directory  is  displayed. 


ARIAN  II  EXECUTIVE  COMMAND: 


Command :  LIST 

Brief  Description:  The  LIST  command  is  used  to  list  all  or  selected  parts 
of  the  primary  file  on  the  principal  I/O  device. 

Format :  LIST  (<lnum>  <lnum>?)7 

Format:  LISTF  (<lnum>  <lnum>?)? 

Format:  LIST!.1  (<lnum>  <lnum>?)? 


The  LIST  command  allows  the  user  to  display  all  or  part  of  the  primary  file 
on  the  pricipal  I/O  device.  All  LIST  variants  are  of  the  same  format:  if  no 
line  number  is  specified,  the  entire  file  is  listed;  only  one  line  is  listed  if 
just  one  line  number  is  specified;  and  a  block  of  lines  is  listed  if  two  lines 
numbers  are  given. 

LIST  displays  the  requested  lines  exactly  as  the  user  typed  them  in.  LISTF 
displays  the  lines  in  an  assembler  format  in  which  all  labels  are  aligned  in  one 
column,  all  op  codes  in  another,  all  operands  in  a  third,  and  all  comments  in  a 
fourth.  This  format  assumes  that  the  user  entered  his  lines  in  an  assembler 
free  format  in  which  all  labels  start  in  the  first  assembly  column  of  each  line 
and  all  op  codes  not  proceeded  by  a  label  start  in  the  second  assembly  column  of 
each  line.  LISTN  displays  the  requested  lines  exactly  as  the  user  typed  them  in 
but  without  line  numbers. 

All  list  displays  are  paged.  This  paging  varies  with  the  logical  I/O 
device  currently  assigned  as  the  principal  I/O  device.  At  the  end  of  a  page, 
the  operator  is  prompted  with  "?",  to  which  he  may  respond  with  "Y"  to  continue 
or  "li"  to  stop.  Also,  the  <EFC>  key  is  monitored  throughout  the  creation  of  the 
display,  and  listing  may  be  terminated  at  any  time  by  simply  hitting  this  key. 


Example:  LIFT  300  400 

Result :  Lines  300  to  400,  inclusive,  are  listed  on  the  user’s  principal 
I/O  device . 

Example:  LIFT  450 

Result:  Line  450  is  listed. 

Example:  LIFT 

Result:  The  entire  primary  file  is  listed. 
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APIAN  II  EXECUTIVE  COMMANDS 


Command :  LNAME 

Brief  Description:  This  command  is  used  to  rename  th^  specified  ioca'> 

file. 

Format:  LIJAK  <fnamc> 

Format:  LNAMB  <fname> 


The  local  rename  command  (LNAMe)  allows  the  user  to  rename  any  local  binary 
or  '  ;xt  file.  LNAM  renames  a  local  text  file,  and  LNAMB  renames  a  local  binary 
file.  In  response  to  this  command,  ARIA?!  prompts  the  user  with  "ME'..'  NAME?" , 
which  he  may  respond  with  the  desired  new  name  for  the  specified  file  or  a  <C 
to  abort  the  renaming  process. 


Example:  LNAM  FILE! 


Result:  ARIA?.'  responds  with  the  prompt  "NEW  NAME?",  to  which  the  user  may 
respond  with  a  valid  file  name  or  a  <CR>.  If  he  responds  with  a  file  name,  like 
FI,  FILE1  is  renamed  FI  in  the  local  text  file  directory;  if  he  responds  with  a 
<CR>,  the  renaming  is  aborted. 
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I  EXECUTIVE  COMMAND: 


Brief  Description :  LOAD  loads  a  file  from  disk  into  memory 


Format:  LOAD  <fname>  <hadr>? 


The  LOAD  command  loads  a  file  from  disk  into  memory.  Only  binary  (type  1) 
and  text  (type  2)  files  may  be  loaded;  an  error  will  be  given  if  the  file  is  of 
some  other  type. 

If  a  text  file  is  loaded,  the  disk  directory  is  searched  for  the  specified 
file  name,  and,  if  found,  the  local  text  file  memory  manager  is  invoked,  the 
local  files  are  compacted,  the  specified  file  is  loaded  into  memory,  and  the  rvw 
file  is  made  primary.  If  a  file  by  the  same  name  already  exists  locally,  tru 
user  will  be  asked  if  he  wishes  to  replace  it  by  the  prompt  "REPLACE?";  if  th 
user  does  not  respond  with  a  "N",  the  file  is  replaced.  If  the  user  specific 
an  address,  the  new  file  is  loaded  into  memory  at  the  specified  address,  bu 
compaction  of  the  secondary  files  is  still  done. 

If  a  binary  file  is  loaded,  the  disk  directory  is  searched  for  th 
specified  file  name,  and,  if  found,  the  file  is  loaded  at  the  execution  addres 
given  by  the  disk  directory.  Any  address  given  in  the  command  becomes  the  lot 
address.  An  entry  is  then  made  in  the  local  binary  file  directory. 


:ul t :  The  disk  file  LASTF  is  loaded  into  memory  at  a  location  designate 
ocal  memory  manager  and  made  primary  if  it  is  a  text  file.  If  it  i 
it  is  loaded  at  its  execution  address.  In  both  cases,  an  entry  is  m;  d 
ippropriatc  local  file  directory. 


Example:  LOAD  FILEX  MOOC 


The  file  FILEX  is  loaded  into  memory  smarting  . 
An  entry  in  the  appropriate  local  file  directory 


Result 


t  location  DC 
is  made  for  it 


hexadecimr 


">  n.  cn  b  -*■  t  >  cj 


ARIA!,'  II  EXECUTIVE  COMMANDS 


Command :  LSCR 

Brief  Description :  The  LSCR  command  clears  (scratches)  the  specified  local 
file  directory. 

Format:  LSCR 

Format :  LSCRB 


LSCR  scratches  (deletes)  all  entries  in  the  specified  local  file  directory. 
LSCR  scratches  the  local  text  file  directory,  and  LSCRB  scratches  the  local 
binary  file  directory.  The  files  themselves  are  not  affected  by  this  command  — 
only  the  directory  entries  for  them. 
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ARIA!!  II  EXECUTIVE  COMMAND? 


Command:  PRINT 

Drief  Description :  The  PRINT  command  is  the  same  as  the  LIST  command,  tut 
the  file  is  displayed  on  the  printer. 

Format :  PRIN  (<lnum>  <lnum>?)? 

Format :  PRINF  (<lnum>  <lnum>?)? 

Format:  PRINK  (<lnum>  <lnum>?)7 


The  PRII.'t  command  displays  the  selected  line  or  block  of  lines  on  tv . 
user’s  printer.  Print  displays  are  not  paged.  PRIN  prints  the  file  as  if 
exists,  PRINF  prints  it  in  assembler  format,  and  PRINK  prints  it  without  1  in¬ 
numbers. 

The  display  can  be  interrupted  and  control  returned  to  ARIAN  by  typing  the 
<ESC>  key. 

If  only  one  line  number  is  given,  just  that  line  will  be  printed.  If  two 
line  numbers  are  given,  that  bloc!:  of  lines,  inclusive,  will  be  printed.  If  no 
line  numbers  are  given,  the  entire  file  will  be  printed. 
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ARIAN  II  EXECUTIVE  COMMANDS 


Command:  RCVR 

Brief  Description :  RCVR  allows  the  user  to  attempt  to  recover  e  local  text 
file  whose  directory  entry  has  been  deleted. 

Format:  RCVR  <fname>  <hadr> 


The  recover  (RCVR)  command  is  used  to  recover  a  text  file  that  has  been 
deleted  from  the  local  text  file  directory.  A  validity  check  is  done  on  the 
file  (see  FCHK)  starting  at  the  address  specified,  and  a  local  text  file 
directory  entry  is  created  with  the  specified  file  name  and  the  file  boundaries 
ascertained  by  the  validity  check.  If  the  validity  cheek  fails,  tin  rceovr  ry  is 
aborted  with  an  appropriate  error  message.  If  the  validity  check  succeeds,  th¬ 
rew  file  is  made  primary  implicitly  through  the  FILE  command. 


Example:  RCVR  OLDFILE  2001 


Result:  A  validity  check  is  started  at  location  20C1  hexadecimal,  and  if 
the  validity  check  succeeds  a  new  local  text  file  of  the  name  OLDFILE  is  entered 
into  the  local  text  file  directory. 
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ARIAt:  II  EXECUTIVE  COMMANDS 


Command :  RESET 


Brief  Description :  The  RESET  command  resets  ARIA!!.  This  is  roughly 
equivalent  to  a  warm  start. 

Format :  RESET 


RESEt  executes  a  system  reset  (warm  start)  of  ARIA!!.  This  system  reset 
includes  the  following  operations: 

1.  The  default  execution  address  is  set  to  the  system, 
reset  entry  point. 

?.  The  assembly  limits  arc  reset. 

3.  The  system  symbol  table  is  cleared, 
d .  The  system  tab  stops  are  reset. 

5.  The  default  stack  pointer  is  reset  for  the  COh’T 
command . 

G.  The  principal  I/O  channel  is  reset  to  the  default 

port. 

7.  Control  is  returned  to  ARIA!!. 
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ART  AN’  II  EXECUTIVE  COMMANDS 


Command :  RNUM 

Brief  Description :  The  RNUM  command  is  used  to  renumber  the  lines  in  the 
primary  file. 

Format:  RNUM  (<lnum>  <inc>?)7 


RNUM  renumbers  the  primary  file.  If  no  arguments  are  given,  the  file  is 
numbered  to  start  at  line  5  and  continue  in  increments  of  5.  If  just  a  line- 
number  is  specified,  the  file  starts  at  the  specified  line  number  and  continues 
in  increments  of  5;  if  both  line  number  and  increment  are  specified,  these 
values  are  used  in  the  renumbering. 


Example:  RN'JM  TOO  40 


Result :  The  primary  file  is  renumbered,  starting  with  line  100  and 
incrementing  by  40;  i.e.,  the  first  line  will  be  100,  and  succeeding  lines  will 
be  140 ,  180,  220,  etc. 


Example :  RNUM 

Result :  The  primary  file  is  renumbered,  starting  at  5  and  incrementing  by 
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A RIAN  II  EXECUTIVE  COMMANDS 


Command :  SAVE 

Brief  Description :  The  SAVE  command  is  used  to  save  a  file  onto  disk  from 
memory . 

Format:  SAVE  <fnsme> 

Format :  SAVEn  <fname> 

Format:  SAVED  <fname>  (<hadr>  <hadr>  <hadr>?)? 

Format :  SAVEBn  <fnsme>  (<hadr>  <hadr>  <hadr>?)7 
Format:  SAVET  <fname>  <hadr>? 

Format:  SAVETO  <fname> 


The  SAVE  command  is  used  to  save  text  and  binary  files  on  disk  and  chance 
the  type  and  execution  address  of  files  currently  residing  on  disk. 

The  SAVE  <fname>  variant  saves  the  current  primary  file  on  disk  under  the 
specified  name.  This  name  is  not  required  to  be  the  same  as  the  local  name  of 
the  primary  file.  Only  the  primary  file  is  saved  by  this  command. 

The  SAVED  variant  saves  a  binary  file  on  disk  under  the  specified  nan.:.  If 
r.o  address  is  given,  the  default  assembly  limits  arc  used  as  the  file  limits. 
If  two  address  arc  given,  these  are  used  as  the  file  limits,  and  if  a  third 
address  is  given,  it  becomes  the  execution  or  load  address.  If  nc  third  address 
is  given,  the  starting  address  of  the  file  becomes  its  execution  or  load 
address. 


SAVET  can  be  used  to  change  the  type  of  a  disk  file.  SAVETO  makes  th"' 
specified  file  a  type  C  (text)  file.  SAVET  makes  the  specified  file  a  binary 
file.  If  <hadr>  is  specified,  its  execution  address  is  set  to  this  value; 
otherwise,  its  execution  address  is  set  to  zero. 

An  optional  fifth  character  for  SAVE  and  sixth  character  for  SAVED  may  be 
specified.  This  is  a  digit  from  1  to  ;  it  specifies  the  number  of  the  disk 
drive  to  save  the  file  on.  This  drive  becomes  the  new  logged-in  drive. 


Example:  SAVE  HEW 

Result:  The  local  primary  text  file  is  saved  on  disk  under  the  name  NEW. 
Note  that  this  name  does  not  necessarily  have  to  be  the  same  as  its  local  name. 


Example:  SAVES  NEV.7 


Result :  The  same  file  is  saved  under  the  name  NEWF  on  disk  drive  2.  Drive 
2  is  now  logged  in. 


ART AN  II  EXECUTIVE  COMMANDS 


Example:  SAVEB1  BIN1  2000  2021  5600 

Result:  The  section  of  memory  from  2000  to  2021  hexadecimal,  inclusive,  is 
saved  on  disk  as  a  binary  file  with  execution  address  5600  hexadecimal.  It  is 
saved  on  drive  1,  and  drive  1  becomes  the  new  logged-in  drive. 


Example:  SAVED  EIt.T2 

Result :  The  section  of  memory  specified  by  the  default  assembly  limits  is 
saved  on  the  logged-in  drive  under  the  name  of  BIN2. 
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ARIA!;  II  EXECUTIVE  COMMANDS 


Command :  SETC 

Driof  Description :  This  command  allows  the  user  to  explicitly  redirect  I/C 
within  ARIA!!. 

Format:  SETC 

Format :  SETCI  <hadr> 

Format :  SETCC  <hedr> 


user 

rout 

rout 

regi 

rout 

rout 

spec 

rout 

spec 


ine  o 
-defin 
ines  i 
incs  i 
ster  a 
SETC 
ines. 
SETCI 
inc. 
i  f  i  ed 
SETCC 
ine. 
i  f  it 


ETC  command  allows  the  user  to  redirect  all  ARIA!.'  system  I/C  throws' 
ed  I/O  routines.  The  parameter  to  be  passed  to  and  from  thc-sa 
s  passed  in  the  A  register.  The  only  constraint  placed  on  these 
s  that  they  do  not  have  a  net  effect  on  the  system  stack  or  any 
nc  they  end  with  a  RET  (return)  instruction. 

by  itself  resets  the  system  I/O  to  employ  the  normal  system  I/O 
This  is  the  default  upon  ARIA!'  initialization. 

(set  customized  input)  allows  the  user  to  redefine  the  system  input 
All  input  is  routed  through  the  subroutine  which  begins  at  the 
address  immediately  after  this  command  is  executed. 

(set  customized  output)  allows  the  user  to  redefine  the  system  output 
All  output  is  routed  through  the  subroutine  which  begins  at  the 
address  immediately  after  this  command  is  executed. 


Exempt  ■:  : 


SETCI  6C0R 


Result  : 
location  OCOO 


All  input  to  ART AT 
hexadecimal . 


is  directed  through  the  subroutine  starting 
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ARIA?:  II  EXECUTIVE  COMKA!.T.r 


Command :  SYMT 

Brief  Description:  The  symbol  table  from  the  last  assembly  is  displayed  to 
the  user  on  the  principal  I/C  device. 

Format:  SYMT 

F ermr  t :  SYMT  <  f name > 


The  SYMT  command  displays  the  symbol  table  produced  in  the  last  assembly  if 


SYMT 

nmv 


the  system  has  not  been  reset  or  the  table  has  not  been  written  ove; 
displays  the  user  program's  symbol  table.  This  is  a  simple  listing  of 
cf  the  symbol  and  its  value. 

The  command  'SYMT'  with  no  arcunents  simply  displays  the  symbol 
described  above.  If  'SYMT'  is  followed  by  the  name  of  a  symbol,  which  is  o 
form  of  <fname>,  then  that  particular  symbol  will  be  searched  for  and  its 
particular  value  will  be  displayed  if  found.  For  example,  'SYMT  DT’.'E'  will 

search*  the  symbol  table  for  the  symbol  'DONE'  2nd  display  its  velu.  if  fount . 


table  as 
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ART  AN'  II  EXECUTIVE  COMMANDS’ 


Command:  TABS 

Brief  Description :  This  command  nllo’..'s  the  user  to  set,  examine,  and  reset 
the  tab  stops. 

Format. :  TABS 

Fermat :  TAP.SL 

Format:  TABSR 


The  TABSet  command  allows  the  user  te  set,  examine,  and  reset  the  ARIA!!  tab 
stops.  In  the  set  and  examine  cases,  the  scale  numbering  the  columns  is  printed 
across  the  page,  and  the  tab  stops  are  denoted  by  the  letter  "X". 

TABS  is  used  to  set  the  tab  stops.  After  the  scale  is  printed,  the  user 
may  space  or  tab  (using  the  previously-defined  tab  stops)  over  to  the  desired 
tab  set  location  and  type  an  "X".  Up  to  twenty  tabs  may  be  set  in  this  way;  the 
process  is  terminated  by  typing  a  carriage  return. 

TAB3L  examines  (lists)  the  tab  stops  as  they  are  currently  set.  Again,  the 
scale  is  printed  and  X's  are  printed  in  the  columns  in  which  tabs  ere  set. 

TABSR  resets  the  tab  stops  to  the  standard  system  definition.  Tabs  arc  set 
at  every  eighth  column. 
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Command :  TERM 

Brief  Description:  This  command  invokes  the  terminal  subsystem  of  the 
UTILITY  PROM. 


Format:  TERM 


The  TERMinal  command  invokes  the  terminal,  or  inter-system  communication, 
mode  of  ARIAN.  Under  this  subsystem,  the  microcomputer  becomes  relatively 

transparent  to  the  user  and  the  user’s  terminal  is  made  to  respond  like  a  norm 
timesharing  terminal  to  an  external  computer  system.  Each  character  typed 
sent  to  a  moder1  and  acoustic  coupler,  and  each  character  received  by  the 

modcm/coupler  is  sent  to  the  user's  CRT. 

The  terminal  subsystem  responds  to  three  subcommands;  they  arc  Ctrl-A, 

Ctrl-L,  and  Ctrl-R.  Ctrl-A  invokes  the  terminal  alternate  command  set;  Ctrl-L 

invokes  the  download  program;  Ctrl-R  returns  control  to  the  calling  program 
(ARIA!!) . 

The  terminal  alternate  command  set  consists  of  the  following  KCS-like 
commands : 


1.  F  —  disable  software  echo  for  full  duplex 
comniunicatior, . 

2.  H  —  enable  software  echo  for  half  duplex  communication. 

?.  K  —  return  to  MCS. 

4.  R  <hndr>  —  run  the  subroutine  located  at  the  specified 
address.  The  return  in  the  subroutine  transfers  control  to  the 
terminal  mode  (not  the  terminal  alternate  command  set). 

5.  T  <hadr>  —  transfer  the  downloaded  code  to  the 
specified  address.  This  command  transmits  a  carriage  return 
(<CR>)  to  the  external  computer,  and  the  object  code  downloaded 
is  loaded  into  memory  starting  at  the  specified  address;  the 
addresses  given  in  the  code  are  ignored,  and  the  entire  code  is 
loaded  sequentially  into  memory. 

6.  X  —  exit  to  terminal  mode. 


Ctrl-L  is  the  download  command  to  the  terminal  mode  subsystem.  A  carriage 
return  (<CR>)  is  transmitted  to  the  external  computer,  and  the  object  code,  in 
It.'TEL-standard  format,  is  loaded  into  the  microcomputer's  memory  at  the 
addresses  specified  in  the  load  blocks. 

Ctrl-R  simply  returns  control  to  the  program  that  called  the  term' nr'1 
subsystem.  This  calling  program  is  usually  ARIA!!. 

Downloading  can  be  interrupted  at  any  time  by  typing  <ESC>  on  the  principal 
I/O  device. 


Example:  TER’' 


Result:  The  terminal  subsystem  is  invoked. 
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Example:  TYPE  .OBJECTS 

Result:  This  the  TYPE  command  to  the  external  computer.  OBJECT  is  an 
object  code  file  in  IHTEL-standard  format.  When  the  terminal  mode  reads  the 
Ctrl-L  from  the  user,  it  transmits  a  <CR>  to  the  external  computer,  thereby 
terminating  the  TYPE  command.  The  terminal  mode  then  downloads  the  incoming 
code  into  memory  and  displays  it  on  the  CRT. 


aria::  ii  executive  commands 


Command :  UTIL 

Brief  Description:  This  command  invokes  the  Memory  Utility  Subsystem. 
Format:  UTIL 


The  UTIL  command  gives  the  user  the  ability  to  examine  and  modify  memory 
directly.  In  response  to  this  command,  the  user  is  prompted  by  ARIA!,'  with  a 
slash  ("/").  He  may  then  enter  the  following  UTILity  subcommands: 

1 .  C  <hadr>  <hadr>  <hadr>  —  copy  the  block  of  memory 
defined  by  the  first  two  addresses  to  the  location  of  memory 
starting  at  the  third  address.  The  original  block  is  unchanged 
unless  the  third  address  resides  within  this  block. 

2.  D  <hadr>?  <hval>*  —  deposit  the  specified  values  into 
memory  starting  at  the  given  address.  If  no  address  is  given, 
the  values  are  deposited  starting  at  the  default  pointer.  V.'hen 
completed,  the  default  pointer  points  to  the  next  byte  to  be 
deposited  into. 

3.  E  (<hadr>  <hadr>?)?  —  examine  a  specific  memory 
location  or  a  block  of  memory.  The  default  pointer  points  to  the 
last  location  examined.  If  only  one  address  is  given,  it  and  its 
contents  will  be  displayed  followed  by  a  ”?",  to  which  the  user 
can  respond  with  a  "B"  to  back  up  (see  the  previous  address)  or 
"F"  to  go  forward  (see  the  next  address).  Any  other  character 
will  exit  this  mode.  If  both  addresses  are  specified,  this  block 
will  be  displayed.  If  no  address  is  specified,  the  address 
pointed  to  by  the  default  pointer  will  be  displayed  as  though  one 
address  was  given. 

4.  F  <hadr>  <hadr>  <hval>*  —  find  all  occurrances  of  th: 
specified  byte  string  in  the  memory  block  bounded  by  the  given 
addresses. 

5.  S  <hadr>?  —  set/display  the  default  pointer.  S  alone 
will  display  the  pointer;  S  with  an  argument  will  set  the  pointer 
to  that  value. 

6.  X  —  return  to  ARIAN  command  mode. 

These  commands  are  a  subset  of  the  KCS  VI. 6  command  set,  and  more  details 
as  to  their  usage  may  be  found  in  the  "MCS  User's  Manual". 


Example:  UTIL 

Result :  The  utility  subsyst  is  invoked. 

Example :  E  0  FF 

Result:  A  block  examine  is  done  of  locations  0  to  FF  hexadocime'1 .  Ti  e 
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output  is  paged. 

Example:  C  0  FF  4000 

Result:  Block  0  to  FF  hexadecimal,  inclusive,  is  copied  to  start  at 
location  4000  hexadecimal. 

Example:  D  2000  0123 

Result:  The  values  0,  1,  2,  and  3  are  deposited  into  memory  locations  2000 
to  2003  hexadecimal.  The  default  pointer  is  now  pointing  to  location  2004. 

Example:  D  4 

Result:  The  value  4  is  deposited  into  memory  location  2004  hexadecim;.' , 
and  the  default  pointer  now  points  to  location  2005  hexadecimal. 

Example :  X 

Result:  UTIL  is  exited  and  control  is  returned  to  A RIAN  command  mode. 
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The  A RIAN  IT  Suffers 


The  following  is  a  description  of  several  of  the  key  buffer  areas  within 
the  ARIAN  II  Scratchpad  RAM  Area.  These  descriptions  include  information  as  to 
the  address  of  the  start  of  the  buffers,  the  format  of  the  information  in  the 
buffers,  and  the  size  of  the  buffers. 


Name  of  Directory/Table :  Disk  Directory 


Entry  Format: 

16  bytes 

File  Name:  G  bytes 

Disk  Address  (low  order,  high  order):  2  bytes 
Number  of  Blocks  (low  order,  high  order):  2  bytes 
File  Type:  1  byte 

Execution  Address  (low  order,  high  order):  2  bytes 
Unused:  1  byte 


Comments: 

All  elements  of  an  entry  except  the  File  Name  are  in  binary.  The  File  Nam 
is  in  ASCII,  with  blank  fill  on  the  right. 

The  buffer  is  large  enough  to  contain  6A  entries.  The  size  of  the  buffer 
is  IK  bytes. 

Each  entry  is  of  the  form  described  above.  If  no  entry  exists  at  a 
particular  location  in  the  directory,  then  the  first  byte  of  the  File  Name  is  a 
space. 

The  Starting  Address  of  the  Disk  Directory  is  F300. 


Name  of  Directory/Table:  Local  Text  File  Directory 


Entry  Format: 

10  bytes 

File  Name:  8  bytes 

Beginning  of  File  (BOF)  Pointer  (low  order,  high  order):  2  bytes 

End  of  File  (EOF)  Pointer  (low  order,  high  order):  2  bytes 
Maximum  Line  Number  (A  ASCII  Characters,  MOD  First):  A  bytes 


Comments : 

The  File  Name  is  in  ASCII,  with  blank  fill  on  the  right.  The  BOF  and  EOF 
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Pointers  are  in  binary,  and  the  Maximum  Line  Number  is  in  ASCII. 

The  buffer  is  large  enough  to  contain  10  entries.  The  size  of  the  buffer 
is  160  bytes. 

If  the  first  byte  of  a  File  Name  is  a  binary  0,  then  there  is  no  directory 
entry  at  this  particular  location. 

The  Starting  Address  of  the  Loco1  Text  File  Directory  is  F09C. 


Ham--*  of  Dirrctory/T-:ble:  Loc»l  Binary  File  Directory 


Entry  Format : 

12  bytes 

File  Name:  S  bytes 

Starting  Address  (lev.'  order,  high  order):  2  byt^s 
Ending  Address  (low  order,  high  order):  2  byt^s 


Comments : 

The  File  Name  is  in  ASCII,  with  blank  fill  on  the  right.  The  Starting  and 
Ending  Addresses  are  in  binary. 

The  buffer  is  large  enough  to  contain  10  entries.  The  size  of  the  buffer 
is  120  bytes. 

If  the  first  byte  of  an  entry  in  the  directory  is  a  space,  then  there  is  no 
entry  at  this  particular  location. 

The  Starting  Address  of  the  Local  Binary  File  Directory  is  F01? 


Nam-  of  Dircctory/TaMe : 


Customized  Command  Tabic- 


Entry  Format: 

6  bytes 

Command  Man;-.  :  4  bytes 

Execution  Address  (lov:  order,  high  order):  2  bytes 


Comments: 

The  Command  Name  is  in  ASCII,  with  blank  fill  on  the  right.  The  Execution 
Address  is  in  binary. 

The  buffer  is  large  enough  to  contain  20  entries.  The  size  of  the  buffer 
is  121  bytes. 

The  first  byte  of  the  table  contains  a  count  of  the  number  of  entries,  and 
the  rest  of  the  table  follows  the  entry  format. 

The  Starting  Address  of  the  Customized  Command  Table  is  FI 30 . 
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Name  of  Directory/Tabic :  Breakpoint  Table 


Entry  Format: 

3  bytes 

Breakpoint  Address  (high  order,  low  order):  2  bytes 
Replaced  Byte:  1  byte 


Comments : 

All  values  are  in  binary. 

Note  the  reversed  order  of  the  address. 

The  buffer  is  largo  enough  to  contain  P  entries.  The  size  of  the  buffer  is 
2A  bytes. 

The  presence  of  an  entry  in  the  Breakpoint  Tabic  is  determined  by  examining 
the  address  at  an  entry  location.  If  this  address  is  binary  0,  then  no  entry 
exists  here.  Note  that  this  prohibits  setting  a  breakpoint  at  location  h. 
The  Starting  Address  of  the  Breakpoint  Table  is  FI  A?. 


Name  of  Directory/Tabic :  Assembler  Symbol  Table 


Entry  Forma*-. : 

6  bytes 

Symbol  Name:  6  bytes 

Symbol  Address  (high  order,  low  order):  2  bytes 


Comments: 

The  Symbol  Name  is  in  ASCII,  with  zero  fill  on  the  right.  The  Symbol 
Address  is  ir.  binary. 

The  buffer  is  large  enough  to  contain  at  least  3S4  entries.  The  slz^  of 
the  buffer  is  flexible,  with  roa::  for  upward  growth,  but  the  allocated  size  r 
3172  bytes. 

Mote  the  reversed  order  of  the  address. 

The  number  of  labels  in  the  Assembler  Symbol  Table  is  contained  ir,  the 
buffer  I.'OLA  (low  order,  high  order).  This  buffer  is  2  bytes  long,  and  its 
Starting  Address  is  F275. 

The  Starting  Address  of  the  Assembler  Symbol  Table  is  F300. 
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The  ARIA!.'  II  BUFFERS  and  JUMP  TABLE 


Name  of  Directory/Table:  Register  Save  Area 


Entry  Format : 

1  or  2  bytes 

The  contents  of  the  registers  are  stored  in  sequential  bytes  in  this 
buffer. 


Comments : 

The  sequence  of  storage  of  the  registers  in  this  area  is  E,  D,  C,  B,  Flags, 
A,  IX  (low  order,  high  order),  IY  (low  order,  high  order),  L' ,  H' ,  E',  D' ,  C, 
B’,  Flags’,  A',  L,  !.',  SB  (low  order,  high  order),  and  PC  (low  crc~r,  high 
order) . 

The  Starting  Address  of  the  Register  Save  Area  is  F1C1. 


Name  of  Directory/Table :  Executive  Parser  Buffers 


Entry  Format: 


Buffer 

Length  t 

Address 

ABUF 

16  bytes 

FI  FT 

BEUF 

S  bytes 

F20D 

CBUF 

8  bytes 

F1F5 

FBUF 

8  bytes 

F1E9 

SBUF1 

Uj  bytes 

F213 

SBUF2 

40  bytes 

F2-r 

Comments : 

These  are  the  buffers  whose  contents  are  filled  by  the  ARIA!;  II  Executive 
Parser. 

ABUF,  CBUF,  and  FBUF  are  ASCII  buffers,  with  blank  fill  on  the  right. 
SBUF1  and  SBUF2  are  ASCII  buffers;  if  they  contain  valid  information,  the  first 
character  in  SBUF1  or  SBUF2  is  a  double  quote,  and  the  last  character  is  a 
carriage  return.  BDUF  contains  binary  values. 

AEUF  and  BEUF  may  contain  up  to  three  entries.  For  ABUF,  each  entry  is 
four  bytes  long;  for  BBUF,  each  entry  is  two  bytes  long  (low  order,  high  order). 

The  special  characters  appended  to  the  command  name  are  stored  in  CBUF  in 
the  5th,  6th,  and  7th  bytes  (SPCHR1,  SPCHR2,  and  SPCHR3,  resp.).  The  address  of 
SPCI1R1  is  FIFO. 
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Selected  ARIA!!  II  Buffers 


Name 

Address  Size 

Use/Function 

Workspace 

Buffers 

WSPE 

F002  f 

Workspace  Pointer  (End) 

WSPS 

FOOD  2 

Workspace  Pointer  (Start) 

Disk  Drive 

Buffers 

CDRIV 

FI  DA  1 

Command  Drive  Dumber  Buffer 

DRIVE!.’ 

FOOA  1 

Logeed-Ir,  Drive  Dumber  Buffer 

Default  Ex 

ecution  Address 

EXADR 

FOOD  2 

Default  Execution  Address 

Paging  Buf 

"fers 

LPCNT 

FO 15  1 

Line  Paging  Count  (Number  of  lines  left  on  pi 

1JL 

F265  1 

Number  of  Lines  on  a  Page 

File  Search  Buffers 

FEF 

FIF'J  1 

Free  Entry  Found  Flag  (use  w/XFSEA) 

FREAD 

F1F2  2 

Free  Entry  in  Directory  Pointer  (use  w/XFSEA! 

Input/Output  Buffers 

I BUF 

PEOO  160 

Input  Line  Buffer  (referenced  by  ZIBF) 

OBUF 

FDEC  1H1 

Output  Line  Buffer  (used  by  Assembler) 

Assembler 

Buffers 

API.'D 

F1E3  2 

Assembler  Line  Pointer  (Pts  to  current, line) 

ASME1! 

F26C  2 

Assembly  End  Address 

ASKRET 

F26F  2 

Assembler  Return  Address 

ASMST 

F26A  2 

Assembly  Start  Address 

ASP  C 

F26P  2 

Assembler  Location  Counter 

UCLA 

F275  2 

Number  of  Labels  in  Symbol  Tabic 

PAST 

F271  1 

Assembler  Pass  Indicator  (1  or  2) 
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The  ARIA!!  II  Jump  Table 


The  following  is  a  listing  of  the  entry  addresses  of  the  routines 
accessable  via  the  ARIA!!  II  Jump  Table. 


The  ARIA!!  II  Jump  Table  Functions 


!  Janie  A 

.ddross 

Regs  Affected 

Function 

XCKA1 1 

AO 

A,UL 

Check  for  the  presence  of  the  1st  argument 
in  BBUF/ABUF.  Return  w/zero  set  if  no  argument, 
ot  zero  if  argument. 

XCKA21 

A3 

A,HL 

Check  for  the  presence  of  the  2nd  argument 
in  BBUF/ABUF.  Return  w/zero  set  if  no  argument, 
not  zero  if  argument. 

XCKFl!  1 

A6 

a.hl 

Check  for  the  presence  of  an  argument  in  FBUF. 
Return  w/zero  set  if  no  argument,  not  zero 
if  argument. 

XDCOK 

69 

-All- 

Execute  the  ARIA!!  II  Disk  Communication 
routine;  this  is  the  same  as  FDOS'  DCC!',  but 
control  is  returned  to  ARIA’I  IT  upon  error. 
Input  register  parameters  arc: 

ML  -  Starting  Disk  Address 

DE  =  Starting  RAF  Address 

B  =  Command  ( 3= write ,  1=resd,  2=verify) 

C  =  Unit  Lumber 

A  =  Number  of  Blocks 

XDSCAI! 

A  9 

-/•I 

Load  and  scan  directory  of  Loggen-In  Drive 
for  file  whose  name  is  in  FDUF.  Return  w/ 
zero  set  if  found,  not  zero  if  not  found. 

If  found,  HL  points  to  1st  byte  of  entry 
in  directory  for  this  file. 

XFILE 

AC 

-All- 

Execute  FILE  command.  This  is  useful  in 
creating  a  new  primary  file  by  loading  FELT 
i  th  the  now  file  name. 

XFir;:. 

AF 

-All- 

Find  a  line  in  the  primary  file  whose  number 
is  greater  than  or  equal  to  the  line  number 
(stored  as  normalized  ASCII)  in  the  first 
element  of  ABUF.  On  return,  HL  points  to  the 

1st  byte  (character  count)  of  the  line  found. 

xfse; 


5E  -All- 


Search  the  local  text  file  directory  for 
the  file  whose  name  is  in  FBUF.  Upon  exit, 
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return  w/not  zero  &  HL  pointing  to  entry  ir, 
directory  if  found.  If  not  found,  return  w/ 
zero  set.  .Also,  if  not  found,  the  Free 
Entry  Flag  (FEF)  is  not  zero  if  there  is 
room  in  the  directory  for  another  file  and 
the  FREAD  buffer  points  to  an  available 
entry  location  in  the  directory. 


xi  iik 

72 

A 

Poll  all  channels  for  an  <ESC>  and  return  to 
the  Executive  if  one  was  typed 

XL  TEE 

r *9 

-All- 

Enter  line  contained  in  IBUF  into  the  primary 
file.  Line  must  be  of  ARIAN  II  format.  The 
assembler-defined  routine  ZLIN  creates  it 
properly.  A  line  number  (not  necessarily 
normalized)  must  begin  the  line. 

XLOAD 

nr, 

-All- 

Execute  the  LOAr  command.  This  is  useful  for 
loading  and  making  primary  a  disk  file  on 
the  Logged-In  Drive.  The  file  name  is  in  FBUF. 

XMESE 

5E 

-All- 

Print  string  ending  in  <CR>  pointed  to  by  HL 
on  the  principal  I/O  device.  Return  to  the 

ARIAN  II  Executive  when  done.  Prefix  the  string 
(as  printed)  w/<CR>  and  a  blank. 

XPARSE 

6C 

-AI 1- 

Enter  the  Executive  Parser  and  parse  the  line 
contained  in  IBUF. 

XREAD 

6F 

HL ,  A 

Enter  the  input  line  editor  and  permit  the  user 
to  enter  a  lino  into  IBUF.  On  exit,  HL  point 
to  the  first  char  of  the  line  (after  the  char 
count ) . 

XRl.'UM 

61 

-All- 

Execute  the  RNUM  command.  The  Primary  File 
is  renumbered.  ABUF  contains  the  non-default 
parameters  as  normalized  ASCII  characters. 

XSAVE 

53 

-All- 

Execute  the  SAVE  command.  This  is  useful  for 
creating  binary  disk  files  or  saving  the 

Primary  File  (text).  Instructions  to  this 
routine  are  passed  in  the  appropriate 

Executive  Parser  Buffers,  especially  SPCHR1. 

The  ARIAN  II  Restart  Entries 

Name 

Address 

Restart 

Function 

XARIAN 

0 

0 

ARIAN  II  Cold  Start 

XBRKP 

3 

1 

Breakpoint  Entry  Address 

XEOR 

66 

- 

Executive  Entry  Address 

XRESET 

U 

- 

ARIAN  II  Warm  Start 

XTRAP 

33 

7 

Memory  Trap  and  Executive  Entry 
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ARIA?.'  II  Standard  Assembler  Program  Line  Format 


Each  line  of  assembly  language  source  code  is  divided  into  from  one  tc  four 
fields.  These  fields  are  the  namev(or  label)  field,  the  operation  field,  the 

operand  field,  and  the  comment  field.  The  name  field  contains  the  label 

assigned  tc  that  particular  line;  this  label  is  a  string  of  alphanumeric 
characters,  the  first  of  which  must  be  alphabetic,  and  it  may  optionally  er.  ■' 
with  a  colon  (:).  The  operation  field  contains  the  mnemonic  or  pseudo-op  which 
defines  the  function.  The  operand  field  contains  the  operands  required  by  th: 
instruction,  and  the  comment  field  is  simply  descriptive  text. 

The  source  line  starts  with  the  first  assembler  line  column  and  extends  to 

the  terminating  carriage  return.  This  column  is  the  sixth  legible  character  of 

the  line;  it  is  the  character  following  the  space  which  fellows  the  four-digit 
line-  number.  Hence,  an  input  line  consists  of  a  four-digit  line  number  a 
space,  and  the  assembly  language  source  code  followed  by  a  carriage  return. 
Blank  lines  are  permitted,  as  are  comment  lines  (lines  which  are  only  comment). 

The  ARIA!!  II  assembler  is  free  format,  but  a  "standard"  format  for  the 
source  code  is  defined  to  work  with  the  f  and  X  options  on  some  commands.  This 
format  is: 

1.  The  name  field  must  start  in  the  first 
assembler  line  column. 

2.  If  the  name  field  exists,  the  operation  field 
starts  one  space  after  the  colon  or  end  of  the  name 
field.  If  the  name  field  does  not  exist,  the  operation 
field  starts  in  the  second  assembler  line  column. 

3.  The  operand  field  starts  one  space  after  the 
operation  field. 

i) .  The  comment  field  starts  one  space  aftc-r  the 
operand  field  if  there  is  one  or  one  space  after  the 
operation  field  if  there  is  no  operand  field.  The 
comment  field  must  start  with  a  semicolon. 

5.  If  the  entire  line  is  a  comment,  it  must  start 
with  either  an  asterisk  (#)  or  a  semicolon  (; )  in  the 
first  assembler  line  column.  The  asterisk  is 
preferred. 
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Assembler  Reserved  Symbols  (Registers) 


Certain  symbols  are  reserved  by  the  assembler  to  refer  to  the  8030/Z8C 
registers.  They  may  only  be  used  in  the  operand  field.  These  symbols  are: 

1.  A  —  the  accumulator;  value  7 

2.  B,  C,  D,  E,  H,  and  L  —  the  B,  C,  D,  E,  H,  and  L 
registers;  values  are  0,  1,  2,  3i  and  5,  respectively 

3.  K  —  memory  (pointed  to  by  HAL) ;  value  6 
L.  P,  PSV.'  —  the  program  status  word ;  value  fi 
5.  S,  SP  —  the  stack  pointer;  value  6 
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Assembler  Reserved  Symbols  (Z-!larnos) 


The  ARIA','  II  assembler  also  reserves  a  number  of  symbolic  names,  all  of 
which  begin  with  the  letter  "Z" .  These  symbols  are  used  to  reference 
subroutines  and  buffers  within  ARIA!,'  II  and  the  UTILITY  PRC!:.  These  symbols 

: 

Symbol  Sample  Usage-  Registers  Affected  Function 


ZARG  CALL  ZARG  -ALL-  the  ARIAN  II  Executive  Parser 

which  parses  the  line  in  IBUF 
as  described  before;  it  may  be 
used  in  conjunction  with  ZLI1; 
to  input  a  command  and  parse  it 
for  the  user's  program;  AB'JF,  BEUF, 
CBUF,  S1PUF,  and  S2EUF  arc 
generated 


ZBBF 

LIILD 

Z5BF 

11/ A 

the  address  of  BBUF,  the  binary 
buffer  created  by  the  Parser 

ZBLK 

CALL 

ZBLK 

A 

output  <SP>  to  principal  I/O 

ZBOF 

L!!LD 

ZBOF 

M/A 

the  address  of  POFP,  the  buffer 
which  contains  the  address  of 
the  first  byte  of  the  primary 
file 

ZCAH 

CALL 

ZCAH 

fl 

convert  the  ASCII  hexadecimal 
character  in  A  to  its  binary 
equivalent  in  A 

ZCHA 

CALL 

ZCHA 

/ 

convert  the  low  nybble  of  A  to 
its  ASCII  hexadecimal  cquiv 
in  A 

ZCR 

CALL 

ZCR 

A 

output  <CR>  <LF>  to  the 
principel  I/O  channel 

ZCRL 

CALL 

DW 

ZCRL 

ADR-C-2 

—NOME— 

Call  Relative  Long 

The  two  bytes  pointed  to 

by  the  return  address  make  up 
the  relative  displacement  from 
the  next  instruction.  The  range 
of  displacement  is  -3276E  to 
+32767. 


ZDOT  CALL  ZDOT 


A 


display  the  A  register  as  up 
to  three  decimal  digits,  left 
space  fill 
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ZEN 

CALL 

ZEN 

A 

exchange  the  nybbles  of  the  A 
register 

ZEOF 

LHLD 

ZEOF 

N/A 

address  of  the  two-byte  buffer 
which  contains  the  address  of 
the  last  byte  of  the  primary 
file 

ZEOR 

JKP 

ZEOR 

M/A 

address  of  the  ARIAN  II 

Executive  reentry  point 
—  this  entry  point  can  be  used 
to  make  a  clean  retur  i  to  ARIAN 
and  preserve  the  environment 
at  the  time  of  program 
execution 

ZHOT 

CALL 

ZHOT 

A 

display  the  A  register  as 
two  hexadecimal  digits 

ZIBF 

LX  I 

H,ZIBF 

M/A 

the  address  mf  the  input  line 
buffer  IBUF;  this  buffer 
is  generated  by  ZLIM 

zit: 

CALL 

ZIN 

A 

input  one  character  from  the 
principal  I/O  channel 

ZI1K 

CALL 

ZINK 

A 

poll  all  channels  for  an  <ESC>; 
if  typed,  control  returned  to 
ARIAN  II  Executive;  return  if 
no  character  or  character  not 
<EFC> 

ZJRL 

CALL 

DVJ 

ZJRL 

ADR- '*-2 

Jump  Relative  Long 
(see  ZCRL) 

ZLIR’ 

CALL 

ZLir: 

A,HL 

the  ARIAN  II  input  line  editor; 
HL  points  to  IBUF  upon  exit 

ZOUT 

CALL 

ZOUT 

-HOLE- 

output  character  in  A  register 
on  principal  I/O  channel 

ZPHL 

CALL 

ZPHL 

A 

print  HL  as  four  hexadecimal 
digits 

ZPPH 

CALL 

ZPPH 

A,I!L 

print  string  pointed  to  by  HL 
ending  in  <CR>  on  printer 

ZPRJ! 

CALL 

ZPR!i 

A.HL 

print  string  pointed  to  by  HL 
ending  in  <CR>  on  principe1 

I/O  channel 

ZPRR 

CALL 

ZPRF; 

A 

i\ 

print  string  pointed  to  by 

return  address  ending  in  <null> 
(binary  0)  on  principal  I/O 
channel 

This  string  would  be-  specified 
ns  "ASC  ’string’  D3  0" 
after  the  call. 

EC  BC  =  HL  -  DE 


ZSHO 


CALL  ZSUD 
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For  quick  reference,  the  following  is  an  alphabetized  list  of  the  Assembler 
Reserved  Symbols  (Z-Names). 


Assembler  Reserved  Symbols  (Z-Narocs) 


Lame 

Name 

ZARG 

ZCR 

ZDBF 

ZCRL 

ZBLK 

ZDOT 

ZBOF 

ZEIi 

ZCAH 

ZEOF 

ZCFIA 

ZEFR 

’Tame 

Name 

ZHOT 

Z.OUT 

ZIBF 

ZPHL 

ZIU 

ZPPH 

ZINK 

ZPRH 

ZJRL 

ZPRR 

ZLTi; 

ZSHD 
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ASSEMBI  EH 


The  following  is  a  list  of  the  Assembler  Reserved  Symbols  (Z-Names)  grouped 
by  function. 


Assembler  Reserved  Symbols  (Z-Hames)  by  Function 


Function 


Executive  Parser 
Internal  Buffers 
Specific  Output 
Register  Output 

Character  I/O 
String  Output 
Input  Line  Editor 
ASCII/HEX  Conversion 

Nybble  Exchange 
Interrupt  Poll 
Branch  Relative  Long 
16-bit  Arithmetic 

ARIA!!  II  Entry 


flames 

ZARG 

ZBBF, 

ZBOF ,  ZECF,  ZIFF 

ZBLK , 

ZCR 

ZDOT , 

ZHC5T,  ZPHL 

Zin, 

ZOUT 

ZPPH, 

ZLT1! 

ZPRH,  ZPRR 

ZCAH , 

ZEN 

ZINK 

ZCHA 

ZCRL , 
Z5HD 

ZEOR 

ZJRL 

Pag- 
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Assembler  Pseudo  Ops 


The  following  is  a  list  and  a  description  of  the  pseudo-ops  reco 
the  ARIA?!  II  Assembler. 

1.  ASC  '<string>'  —  ASCII  string  definition. 

This  pseudo-op  loads  consecutive  memory  locations 
starting  at  the  current  value  of  the  location  counter 
with  the  ASCII  values  of  the  characters  specified  in 
the  string. 

2.  DP  Oxpression>  —  define  one  byte.  This  . 

instruction  evaluates  the  specified  operand  and  loads 
one  8-bit  value  into  the  memory  location  pointed  to  by 
the  location  counter.  If  the  number  is  evaluated  into 

a  1 6-bit  quantity,  only  the  low-order  byte  is  loaded. 

3.  DS  <expression>  —  define  storage.  This 
reserves  the  specified  number  of  bytes  starting  at  the 
current  value  of  the  location  counter. 

M.  DW  <expression>  —  define  one  word.  This 
instruction  evaluates  the  specified  operand,  producing 
a  16-bit  value  which  it  loads  into  memory  (low  order, 
high  order)  at  the  memory  location  pointed  to  by  the 
location  counter  and  the  next  memory  location. 

5.  E!!D  —  end  the  assembly.  This  statement  is 
net  required;  assembly  will  stop  when  the  end  of  the 
file  is  reached  or  this  statement  is  encountered. 

6.  <label>  EQU  <expression>  —  the  specified 
label  is  assigned  the  computed  value  of  the  operand; 
the  computed  value  is  a  15-bit  quantity. 

7.  EXEC  <expression>  —  the  default  execution 
address  is  set  to  the  value  of  the  expression. 

8.  LET  —  turn  on  the  listing  of  the  assembly  of 
the  program  on  the  principal  I/O  device  if  it  is  not 
already  on.  This  can  be  used  in  conjunction  with  HLET 
to  list  only  selected  portions  of  a  program  during  an 
assembly. 

9.  NLST  —  turn  off  the  listing  of  the  assembly 
of  the  program. 

10.  ORG  <expression>  —  set  the  origin  (location 
counter)  to  the  specified  value.  This  instruction  also 
resets  the  assembly  limits  and  the  location  in  memory 
at  which  the  object  code  is  loaded.  If  an  ORG  appears 
more  than  one  time  in  the  program,  the  limits  set  by 
the  last  ORG  and  the  end  of  the  assembly  are  reflected 
in  the  assembly  limits  displayed  by  the  LDIRB  command. 
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All  pseudo-ops  may  be  proceeded  by  a  label. 

The  following  is  an  alphabetized  list  of  the  Assembler  Pseudo  Op 


Assembler  Pseudo  Ops 


Name 

Name 

A  SC 

EQU 

DB 

EXEC 

DS 

LST 

dv: 

KLST 

END 

CRO: 

The  following  is  a  list  of  the  Assembler  Pseudo  Ops  organized  by  function 


Assembler  Pseudo  Ops  by  Function 


Function 

Name 

Constant  Definition 

ASC, 

DB,  1 

Storage  Reservation 

DO 

Label  Assignment 

EOU 

Location  Counter 

ORG 

Execution  Address 

EXEC 

List  Control 

LST, 

NLST 

End  of  Assembly 

END 
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8030  Mnemonics 


Mnemonic 

Mnemonic 

Mnemonic 

Mnemonic 

A  Cl 

ADC 

ADD 

ADI 

ANA 

mi 

CALL 

CC 

c: 

CM  A 

CKP 

CMC 

g;z 

CP 

CPE 

CPI 

CPC 

CZ 

DAA 

DAD 

DCR 

DCX 

DI 

El 

HLT 

IN 

I!!R 

I  NX 

JC 

JK 

JMP 

JNC 

JUZ 

•JP 

JPE 

JPC 

JZ 

LDA 

LDAX 

LHLD 

LX  I 

MV  I 

MOV 

NOP 

ORA 

ORI 

OUT 

PCHL 

PCP 

PUSH 

RAL 

RAF 

RC 

RET 

RLC 

RM 

RL'C 

RNZ 

RP 

PPE 

RPC 

RRC 

RST 

RZ 

BBT 

S5I 

SHLD 

SPliL 

5TA 

STAX 

STC 

SUB 

SUMMARY  of  the  ARIA!!  II  ASSEMBLER 


i 


Z80  Mnemonics 


Mnemonic  A  Operand 

ZILOG  Equiv 

Comments 

SSPD  <exprcssion> 

LD  (nn),SP 

store  SP  direct 

LSPD  <expression> 

LD  SP, (nn) 

load  SP  direct 

SBCD  <expression> 

LD  (nn),BC 

store  BC  direct 

LBCD  <cxpression> 

LD  BC, (nn) 

load  EC  direct 

SDEE  <expression> 

LD  (nn),DE 

store  DF.  direct 

LDED  <expression> 

LD  DE, (nn) 

load  DE  direct 

EXA 

EX  AF,AF' 

EXX 

EXX 

BR  <expression> 

JR  n 

branch  relative 

BC  <expression> 

JR  C,n 

branch  relative 

on 

carry 

BI!C  <expression> 

JR  !!C,n 

branch  relative 

on 

no  carry 

BZ  <expression> 

JR  Z,n 

branch  relative 

on 

zero 

E!!Z  <expression> 

JR  NZ,n 

branch  relative 

on 

nc  zero 

DDJ  <expression> 

DJJJZ  n 

decrement  B  and 

branch  relati 

vs  on  no  20: 


Bloch  Transfer  Group 
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demonic  A  Operand 

ZILOG  Equiv 

Comments 

CD 

CPD 

Compare  Group 

CDR 

CPDR 

Cl 

CPI 

CIR 

CPIR 

NEC 

KEG 

Negate  A 

RLD 

RLD 

Nybble  Rotate 

RRD 

RRD 

SHE? 

SBC  HL , DC 

16-bit  subtract  with  carry 

SHD 

SBC  HL.DE 

cue 

SBC  HL,SP 

AHE 

ADC  HL.BC 

16-bit  add  with  carry 

AMD 

ADC  HL.DE 

AHS 

ADC  HL,SP 

JHO 

IM  0 

Interrupt  Mode  Control 

I  Ml 

IK  1 

IK2 

IK  2 

ID 

HID 

Input  Group 

IDR 

INDR 

II 

INI 

HR 

I  KIR 

OD 

OUTD 

Output  Group 

DDK 

OTDR 

OT 

OUTI 

CIR 

OTIR 

cik 

II!  A ,(C) 

C-Register  I/C 

COT 

OUT  ( C ) , A 

Pace 
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Error  Messages 


Error  Meaning 

A  Argument  error.  The  instruction's  argument  is  of  the  wrong  typo 
or  generally  incorrect. 

D  Duplicate  label  error.  The  label  of  this  instruction  has  been 
used  elsewhere. 

L  Label  error.  The  label  of  this  instrucion  contains  an  invalid  character. 

M  Missing  label  error.  A  required  label  is  missing. 

C  Opcode  error.  The  opcode  in  the  operation  field  of  this  instrucion 

is  invalid 

R  Register  error.  The  register  name  is  missing  or  invalid. 

E  Syntax  error.  The  instruction  syntax  is  incorrect. 

U  Undefined  symbol.  The  referenced  symbol  is  not  defined. 

V  Value  error.  The  computed  value  cannot  be  represented  as  a 

16-bit  value  or  the  instruction  has  a  syntax  error.  Also,  an  8-bit 
value  may  have  been  required  and  a  16-bit  value  was  generated. 
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